Skip to content
Docs

vercel upgrade

The vercel upgrade command upgrades the Vercel CLI on your machine to the latest version published to npm. It detects which package manager you used to install the CLI and runs the corresponding upgrade command. You can also use this command to enable or disable automatic updates.

terminal
vercel upgrade

Upgrade the Vercel CLI to the latest published version.

terminal
vercel upgrade

Upgrade the Vercel CLI to the latest published version using the package manager that installed it.

terminal
vercel upgrade --dry-run

Print the command that would be executed without making any changes.

terminal
vercel upgrade --enable-auto

Opt into automatic Vercel CLI updates for future releases.

terminal
vercel upgrade --disable-auto
Opt out of automatic updates.
terminal
vercel upgrade --format=json

Emit the upgrade plan as JSON. Implies --dry-run; no upgrade is performed.

These are options that only apply to the vercel upgrade command.

The --dry-run option prints the upgrade command that would be executed without running it.

terminal
vercel upgrade --dry-run
Show what would happen, without actually upgrading.

The --enable-auto option turns on automatic CLI updates for future releases.

terminal
vercel upgrade --enable-auto
Enable automatic updates.

The --disable-auto option turns off automatic CLI updates.

terminal
vercel upgrade --disable-auto
Disable automatic updates.

The --format option, value json, emits the upgrade plan as JSON. This implies --dry-run, so no upgrade is performed.

terminal
vercel upgrade --format=json

Output the upgrade plan as JSON for scripting or agent workflows.

If vercel upgrade can't infer the package manager from a lockfile near the CLI install, it falls back to npm and runs npm i -g vercel@latest (or the non-global equivalent). Use vercel upgrade --dry-run first if you need to confirm exactly which command will run, then re-run without --dry-run (or run the printed command yourself) once you've reviewed it.

The following global options can be passed when using the vercel upgrade command:

For more information on global options and their usage, refer to the options section.

Last updated June 9, 2026

Was this helpful?

supported.