Every time you publish changes, Mintlify creates a new deployment. You can browse deployment history, see what changed in each deploy, and redeploy a previous version if needed.
View deployment history
In your Mintlify dashboard, go to [Project] → Deployments. The list shows every deployment with:
- The commit message and Git SHA.
- The author and timestamp.
- The deployment status (success, failed, or building).
Click any deployment to see its details, including the build log.
What changed
Each deployment links to a Git commit. Click View commit to see the full diff in GitHub or GitLab — every page change, navigation update, and configuration change.
For web editor changes
Web editor publishes create commits with the message Update [page title] and your Mintlify account as the author. The commit contains the MDX file changes for pages you edited.
Redeploy a previous version
If a deploy introduced a problem and you need to roll back:
- Go to [Project] → Deployments.
- Find the last known-good deployment.
- Click Redeploy to re-run that deployment.
Alternatively, revert the commit in your Git repository — Mintlify will automatically deploy the reverted version.
For critical docs sites (API references, onboarding guides), test significant changes in a preview deployment before merging to your default branch. Pull request previews give you a live URL to share for review.
