Rollback vs Revert

Incident vocabulary + crisis communication that makes teams faster

When an incident hits, vocabulary becomes operational.

Bad language creates chaos:

• “We fixed it” (did we mitigate or remediate?)

• “We rolled back” (runtime) vs “we reverted” (code)

• “It’s resolved” (for who? users? internal?)

Let’s clean it up.

Photo by British Library on Unsplash

The two-layer incident model

Runtime actions (stop the bleeding)

• rollback

• disable feature flag

• scale up/down

• cut traffic

• fail over

Code actions (fix the source)

• revert commit

• patch forward

• add tests

• change config defaults

Key words (use them precisely)

Photo by Amol Tyagi on Unsplash

Mitigation

Immediate action to reduce impact.

“We mitigated by disabling the feature flag.”

Remediation

Permanent fix + prevention.

“We remediated by fixing the query and adding guardrails.”

Rollback

Deploy a previous known-good artifact.

“Rollback to 1.9.2.”

Revert

Create a new commit that undoes a previous commit.

“Revert commit abc123 on main.”

Hotfix

An urgent change shipped outside normal cadence.

The crisis communication template (copy/paste)

Photo by Markus Winkler on Unsplash

When incidents happen, people don’t need poetry. They need structure.

First message (fast)

Incident: payments failing for some users

Impact: elevated error rate on checkout

Start time: 14:07 UTC

Current status: investigating

Next update: in 15 minutes

Owner: @name

Update message (every X minutes)

Update: identified cause (db connection pool exhausted)

Mitigation in progress: disabling feature flag + scaling API

User impact: improving / still ongoing

Next update: 15 minutes

Resolution message

Resolved: checkout errors back to baseline

Mitigation: feature disabled, rollback to 1.9.2

Remediation: fix in progress, tests added

Follow-up: postmortem scheduled + actions tracked

One rule that saves reputations

Photo by Tingey Injury Law Firm on Unsplash

Never say “fixed” unless you can say what changed and what the metric did.

“Errors dropped from 8% to 0.2% after rollback.”

Cheat sheet

• Mitigation = reduce impact now

• Remediation = permanent fix + prevention

• Rollback = runtime back

• Revert = code undone

• Hotfix = urgent ship

Next: GitOps + IaC + promotion — modern CD vocabulary.