Skip to content
promote
1 min read

vercel promote

Learn how to promote an existing deployment using the vercel promote CLI command.
Table of Contents
Choose a framework to optimize documentation to:

    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. You can bypass this prompt by using the `--yes` option.

    Usage

    terminal
    vercel promote [deployment-id or url]

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

    Unique Options

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

    Timeout

    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.

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

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

    Global Options

    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 September 29, 2023
    Previous
    project
    Next
    pull
    Choose a framework to optimize documentation to: