Archive and restore a project

Pause a Mintlify project without deleting it, and restore it when needed.

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

1. Open the project in your Mintlify dashboard.
2. Go to Settings → Danger zone.
3. 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

1. Go to your dashboard and click Archived projects.
2. 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.