Rollbacks
Restore your live Mintlify site to a previous successful build from your dashboard without reverting commits or waiting for a rebuild.
Roll back your live site to any of your last 10 successful builds. A rollback changes which build your site serves. It does not revert commits in your repository and it does not trigger a new build, so your site changes in seconds.
Use a rollback when a change reaches your live site that you must remove immediately.
Editors and admins can roll back a deployment. The Roll back and Promote buttons do not appear for viewers.
Roll back to a previous build
Section titled “Roll back to a previous build”View your activity history.
Navigate to the activity page in your dashboard.
Find the build you want to serve.
On the Live tab, click a successful build to expand it.
Use the commit message and author to help you identify the build that you want to roll back to.
The most recent successful build does not have a Roll back button because your site already serves it.
Roll back.
Click Roll back. Your site serves the selected build within seconds.
Return to the latest build
Section titled “Return to the latest build”Your site continues to build while it serves a previous build. New commits build and appear in your activity history, but they do not go live until you return to the latest build.
There are two ways to return to the latest build:
- Click Undo rollback on the build you rolled back to.
- Click Promote on the most recent successful build.
Both serve the most recent successful build, including any commits that landed in the meantime.
Limitations
Section titled “Limitations”- You can roll back to any of your last 10 successful builds.
- Projects with authentication enabled do not support rollbacks.
- You cannot roll back a preview deployment.
- You cannot roll back to a build that completed before rollbacks became available.
Review rollback history
Section titled “Review rollback history”Your audit logs record rollbacks and promotions under the Project category, including who performed each action and when.