Archiving a Mintlify project stops new deployments and makes the project inactive, but doesn’t delete your repository or any content. You can restore an archived project at any time.
Archive a project
- Open the project in your Mintlify dashboard.
- Go to Settings → Danger zone.
- Click Archive project and confirm.
After archiving:
- The project no longer appears in your main project list (it moves to Archived projects).
- No new deployments will trigger from Git pushes.
- The live site URL continues to serve the last deployed version.
When to archive
Archive a project when:
- A product or docs site is retired but you want to preserve access to the last live version.
- You’re restructuring projects and want to consolidate docs into a new project.
- The project is on hold and you don’t want accidental deploys from stale branches.
Restore a project
- Go to your dashboard and click Archived projects.
- Find the project and click Restore.
Restoring reactivates the project — deployments will trigger again on the next Git push.
After restoring
- Check that the GitHub App still has access to the repository (it may have been updated while the project was archived).
- Trigger a manual deploy if the repository has changed since archiving: go to Project → Deployments → Redeploy.
Delete a project
Deleting a project is permanent and cannot be undone. It removes the project from Mintlify but does not delete your Git repository.
To delete: Settings → Danger zone → Delete project. You must type the project name to confirm.
Deleting a project removes all Mintlify-side configuration, analytics history, and custom domain settings. Export any analytics data you want to keep before deleting.
