Skip to content
Search...

vercel remove

Learn how to remove a deployment from the command line.

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

Note: You can also remove deployments from the Project Overview page on the Vercel Dashboard.

Usage

vercel remove [deployment-url]

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

Extended Usage

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

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

vercel remove [project-name]

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

Note: By using the project name, the entire project will be removed from the account unless the --safe is used.

Global Options

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

  • --cwd
  • --debug
  • --global-config
  • --help
  • --local-config
  • --scope
  • --token

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

Unique Options

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

Safe

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

Usage Example

vercel remove my-project --safe

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

Yes

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

Usage Example

vercel remove my-deployment.com --yes

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