Skip to content
2 min read

vercel remove

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

    The vercel remove command, which can be shortened to vercel rm, is used to remove deployments either by ID or for a specific Vercel Project.

    You can also remove deployments from the Project Overview page on the Vercel Dashboard.
    terminal
    vercel remove [deployment-url]

    Using the vercel remove command to remove a deployment from the Vercel platform.

    terminal
    vercel remove [deployment-url-1 deployment-url-2]

    Using the vercel remove command to remove multiple deployments from the Vercel platform.

    terminal
    vercel remove [project-name]

    Using the vercel remove command to remove all deployments for a Vercel Project from the Vercel platform.

    By using the project name, the entire Vercel Project will be removed from the current scope unless the --safe is used.

    These are options that only apply to the vercel remove command, therefore, more information is provided.

    The --safe option, shorthand -s, can be used to skip the removal of deployments with an active preview URL or production domain when a Vercel Project is provided as the parameter.

    terminal
    vercel remove my-project --safe

    Using the vercel remove command with the --safe option.

    The --yes option, shorthand -y, can be used to skip the confirmation step for a deployment or Vercel Project removal.

    terminal
    vercel remove my-deployment.com --yes

    Using the vercel remove command with the --yes option.

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

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

    Last updated on February 8, 2023