vercel promote

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

vercel promote [deployment-id or url]

Show the status of any current pending promotions.

vercel promote status [project]

Examples:

# Check status for the linked project
vercel promote status
 
# Check status for a specific project
vercel promote status my-project
 
# Check status with a custom timeout
vercel promote status --timeout 30s

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.

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

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

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --non-interactive
• --scope
• --team
• --token
• --version

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