Rollback

Definition
A rollback is the act of reverting a system to a previous working state after a new release causes a problem.

Why it matters

The speed of the fix decides how bad a mistake is. Without a rollback, a bad release means debugging live while customers hit errors. With one, the choice is simple: restore the last good version first, then investigate calmly. This also changes behaviour. Teams that can undo a release in minutes ship smaller changes more often, because a mistake costs little.

How to apply it

  • Keep releases small. A small change is quicker to diagnose and safer to reverse.
  • Practise a rollback before it is needed, so the steps are known and not invented under pressure.
  • Watch error rates and key pages straight after each release, so a problem is spotted by the team first.
  • Decide in advance who can trigger a rollback, and agree that rolling back needs no justification.
  • Afterwards, write down what went wrong and add a check that would have caught it.

What it is

Every release replaces something that worked with something new, and sometimes the new version breaks. A rollback undoes the release. The live product goes back to the last version known to be good, and the faulty change is set aside to be fixed.

On a modern hosting platform this is often a single action. Vercel, for example, keeps previous deployments and can point the live site at an older one in moments. Databases are harder. A change to the data itself may not undo cleanly, so a rollback plan has to say what happens to records created while the bad version was live.

Common mistakes

  • Treating a rollback as a failure to be avoided, which delays the decision while customers are affected.
  • Forgetting the database. Code can be reverted in minutes, but a changed data structure may need its own plan.
Worked example

Suppose a small web team releases a new checkout page on a Friday afternoon. Within minutes, error reports show that the payment button fails for a share of visitors. The team has practised a rollback, so the person on call knows the steps and needs no approval to take them. The site is hosted and deployed through Vercel, and the team points the live site back at the previous release. The faulty change is set aside. Visitors stop seeing errors within the hour, and only then does the team look at the cause. The next day they add a test that exercises the payment button before any release, so the same break is caught before it reaches customers.

Tools in the example

Some links are affiliate links: we may earn a commission at no cost to you. It never decides a ranking. How we work with partners

  1. Article

    Feature flag

    A switch that limits exposure before a full rollback is ever needed.

  2. Article

    Deployment

    The release that a rollback reverses.

  3. Article

    Staging environment

    Where a change is tested before it reaches customers.

  4. Article

    Version control

    The history that makes an earlier version recoverable.

Where it shows up

  • Writing copy that feels like conversation instead of marketing. How to sound like yourself.
    12 chapters