diff --git a/content/cli/build/drone-build-promote.md b/content/cli/build/drone-build-promote.md
index 9b58ddd87..e554d7de8 100644
--- a/content/cli/build/drone-build-promote.md
+++ b/content/cli/build/drone-build-promote.md
@@ -20,10 +20,21 @@ OPTIONS:
    --param value, -p value  custom parameters to be injected into the job environment.
 ```
 
-Example usage, promotes a build by build number:
+Example usage promotes in the pipeline:
 
 ```
-$ drone build promote octocat/hello-world 42 production
+kind: pipeline
+name: default
+
+steps:
+- name: test
+  image: node
+  environment:
+    foo: ${foo}
+    baz: ${baz}
+  commands:
+  - npm install
+  - npm test
 ```
 
 Example usage, with custom parameters:
@@ -32,4 +43,4 @@ Example usage, with custom parameters:
 $ drone build promote octocat/hello-world 42 production \
   --param=foo=bar \
   --param=baz=qux \
-```
\ No newline at end of file
+```