Menu
Important
Stay updated on React2Shell

vercel promote

Last updated September 24, 2025

The command is used to promote an existing deployment to be the current deployment.

Deployments built for the Production environment are the typical promote target. You can promote Deployments built for the Preview environment, but you will be asked to confirm that action and will result in a new production deployment. You can bypass this prompt by using the option.

Using vercel promote will promote an existing deployment to be current.

These are options that only apply to the command.

The option is the time that the command will wait for the promotion to complete. When a timeout occurs, it does not affect the actual promotion which will continue to proceed.

When promoting a deployment, a timeout of will immediately exit after requesting the promotion. The default timeout is .

Using the vercel promote command with the --timeout option.

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

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


Was this helpful?

supported.