Deployments

Manage documentation deployments in the Mintlify dashboard, including viewing deployment history, monitoring build status, and troubleshooting.

Your documentation site automatically deploys when you push changes to your connected repository. This requires the Mintlify GitHub app to be properly installed and connected.

If your latest changes are not appearing on your live site, first check that the GitHub account or organization that owns your docs repository has the GitHub App installed. See GitHub troubleshooting for more information.

If you have the GitHub App installed, but changes are still not deploying, manually trigger a deployment from your dashboard.

Manually trigger a deployment

1. Verify your latest commit was successful.

   Check that your latest commit appears in your docs repository and did not encounter any errors.

2. Manually trigger a deployment.

   Go to your dashboard and click the deploy button.

   

Delete a deployment

You can permanently delete a deployment from the Danger zone in your dashboard settings. This action is irreversible and removes all deployment data, including any associated preview deployments.

Only organization admins can delete a deployment. If you are not an admin, ask an admin in your organization to perform this action.

1. Navigate to the Danger zone.

   Go to the Danger zone in the settings page of your dashboard.

2. Delete the deployment.

   1. In the Delete my deployment section, provide a reason for deletion.
   2. Click the delete button and confirm that you want to delete the deployment.

Deleting a deployment is permanent and cannot be undone. If you have an active subscription, you’ll receive a prorated credit for any unused time remaining in your billing period.

If you have multiple deployments, Mintlify redirects you to another deployment after deletion. If you delete your only deployment, Mintlify redirects you to the Mintlify homepage. When you delete a deployment, the organization admin receives an email notification confirming the deletion.

Delete your organization or account

Mintlify does not have a separate “delete organization” or “delete account” control. Your organization exists to contain your deployments, so removing your deployments is how you decommission it.

• If your organization has a single deployment, follow Delete a deployment to remove it. Deleting your only deployment effectively decommissions the organization: any active subscription is cancelled with a prorated credit, and you are redirected to the Mintlify homepage.
• If your organization has multiple deployments, delete each one from the Danger zone to fully wind down the organization.

What is removed when you delete your only deployment:

• All deployment data, including preview deployments, content, and analytics history.
• Your active subscription for that deployment, with a prorated credit for any unused time in the billing period.

What is retained:

• The organization record itself, including its name and member list, remains in Mintlify’s systems so that historical billing records stay attached to a valid entity. The organization has no active deployments and incurs no further charges.
• Prior billing history and invoices are kept for accounting and tax purposes.

If you need the organization record, member list, or personal account data itself erased (for example, to exercise a data deletion right), contact [e-mail] after deleting your deployments.

Only organization admins can delete deployments and therefore decommission an organization. Non-admin members should ask an admin in their organization rather than contacting support.