Managing Deployments (CLI)

Listing, inspecting, logging, promoting, rolling back, removing deployments, and running rolling releases.

Once code is deployed, these commands let you observe and control which deployment is live. Background concepts are on Deployments and environments.

`vercel list` (alias `vercel ls`)

Lists recent deployments for the linked project.

vercel list
vercel list --prod          # production deployments only

`vercel inspect`

Shows details for one deployment — state, URL, build info, assigned domains.

vercel inspect <deployment-url>

`vercel logs`

Streams or fetches logs for a deployment.

vercel logs <deployment-url>
vercel logs <deployment-url> --level error   # filter by severity

`vercel promote`

Promotes an existing deployment to production by re-aliasing the production domain to it — no rebuild.

vercel promote <deployment-url>

Pairs well with vercel deploy --prod --skip-domain when you want to build first and flip traffic over later.

`vercel rollback`

Reverts production to a previous deployment. Because it's an alias operation, it's near-instant.

vercel rollback              # roll back to the previous production deployment
vercel rollback <deployment-url>   # roll back to a specific one

`vercel rolling-release`

For gradual production rollouts (shift traffic over progressively, then complete or abort).

vercel rolling-release configure --cfg='[config]'
vercel rolling-release start    --dpl=<deployment-id>
vercel rolling-release approve  --dpl=<deployment-id>
vercel rolling-release complete --dpl=<deployment-id>

`vercel remove` (alias `vercel rm`)

Deletes deployments. Use with care — this removes the deployment and its unique URL.

vercel remove <deployment-name>
vercel remove <deployment-url> --yes

`vercel redeploy`

Re-runs a deployment without changing source (covered in Deploying).

Managing Deployments (CLI)

On this page