vercel promote

Learn how to promote an existing deployment using the vercel promote CLI command.
Table of Contents

The vercel promote 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 --yes option.

terminal
vercel promote [deployment-id or url]

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

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

The --timeout option is the time that the vercel promote 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 0 will immediately exit after requesting the promotion. The default timeout is 3m.

terminal
vercel promote https://example-app-6vd6bhoqt.vercel.app --timeout=5m

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.

Last updated on August 29, 2024