diff --git a/docs/guide/upgrade.md b/docs/guide/upgrade.md
index fe0a4997b8..1e834cb3b6 100644
--- a/docs/guide/upgrade.md
+++ b/docs/guide/upgrade.md
@@ -14,8 +14,10 @@ You can upgrade both of them independently.
 ## Global `vp`
 
 ```bash
-vp upgrade              # upgrade to the latest version
-vp upgrade --check      # check for updates without installing
+vp upgrade                        # upgrade to the latest version
+vp upgrade --check                # check for updates without installing
+vp upgrade <version>              # install a specific version
+vp upgrade --registry <registry>  # use a custom npm registry
 ```
 
 ### Rollback