Vercat
Download

How to roll back a Vercel deployment

Undo a bad production deploy in seconds with Instant Rollback, from the dashboard, the CLI, or your phone. Plus the one setting rollback changes that catches people out.

Updated

Something broke in production and you need the last good version back now. Vercel’s Instant Rollback does this without a rebuild: it points your production domains at a deployment that already exists. Here is how to do it from wherever you are.

Before you start

From the Vercel dashboard

  1. Open the project and go to Deployments.
  2. Find the last deployment that worked and open its menu.
  3. Choose Instant Rollback and confirm.

From the Vercel CLI

# Roll back to a specific deployment
vercel rollback https://my-app-abc123.vercel.app

# Check how it went
vercel rollback status my-app

Pass the URL or ID of the deployment you want back. The command waits up to three minutes by default; change that with --timeout.

From your phone

If you are not at a laptop, Vercat can do it. Open the earlier production deployment you want, open its actions, and choose Set production to this commit. It asks you to confirm before routing production traffic back. The same sheet has Redeploy and Promote to production.

The catch: auto-assignment is now off

After a rollback, Vercel stops assigning production domains automatically. This is deliberate: it stops the next push from overwriting your fix. But it also means that once you have shipped the real fix, it will build and then sit there without going live.

To go back to normal, promote the fixed deployment:

vercel promote https://my-app-def456.vercel.app

Or use Undo Rollback in the dashboard. Either one turns auto-assignment back on.

Rollback or redeploy?

Roll back when the previous version was fine and you need production working again now. Redeploy when the code is fine but the build was not, such as a flaky dependency install or an environment variable you have just fixed. A redeploy runs a new build, so it takes as long as your normal deploys.

FAQ

Can I roll back on the Hobby plan?

Yes, but only to the previous production deployment. Pro and Enterprise can roll back to any eligible deployment.

Why did my next push not go live after a rollback?

Rolling back turns off auto-assignment of production domains. New pushes still build, but they stay off your domain until you promote a deployment or undo the rollback.

Does a rollback rebuild the project?

No. Instant Rollback points your production domains at a deployment that already exists, which is why it takes seconds.

What is the difference between rollback and promote?

Rollback moves production back to an earlier production deployment. Promote makes any deployment, including a preview, the production one. Both are one command in the Vercel CLI.

Vercel, in your pocket.

Push alerts, logs, rollbacks and usage for every project. 7-day free trial for eligible subscribers.