diff --git a/pages/common/pulumi-up.md b/pages/common/pulumi-up.md
new file mode 100644
index 0000000000..3160990c22
--- /dev/null
+++ b/pages/common/pulumi-up.md
@@ -0,0 +1,16 @@
+# pulumi up
+
+> Create or update the resources in a stack.
+> More information: <https://www.pulumi.com/docs/cli/commands/pulumi_up/>.
+
+- Preview and deploy changes to a program and/or infrastructure:
+
+`pulumi up`
+
+- Automatically approve and perform the update after previewing it:
+
+`pulumi up --yes`
+
+- Preview and deploy changes in a specific stack:
+
+`pulumi up --stack {{stack}}`
diff --git a/pages/common/pulumi.md b/pages/common/pulumi.md
index 260c50326a..005f53d81b 100644
--- a/pages/common/pulumi.md
+++ b/pages/common/pulumi.md
@@ -1,6 +1,7 @@
 # pulumi
 
 > Define infrastructure on any cloud using familiar programming languages.
+> Some subcommands such as `pulumi up` have their own usage documentation.
 > More information: <https://www.pulumi.com/docs/reference/cli>.
 
 - Create a new project using a template: