Drafts and publishing

How drafts work in the web editor and what happens when you publish.

The web editor auto-saves your work as you type. Changes are private — they won’t appear on your live docs site — until you click Publish.

Drafts

While you’re editing, your changes are saved as a draft in Mintlify. Drafts are visible to other editors with access to the project, so collaborators can review your work before it goes live.

Multiple editors

If two editors are working on the same page at the same time, Mintlify merges changes on a section-by-section basis. For busy pages with frequent edits, coordinate with teammates to avoid editing the same section simultaneously.

Exiting without publishing

If you close the editor without publishing, your draft is saved. The next time you open the editor, you’ll see the unpublished changes and can continue editing or discard them.

Publishing

Click Publish in the top-right corner of the editor to deploy your changes. Publishing commits your changes to the repository and triggers a new deployment.

Deployments typically complete in 30–60 seconds. You can monitor the progress in your Mintlify dashboard under Deployments.

Before publishing

• Preview the page using the preview toggle in the editor.
• Check that all links point to valid pages.
• If the page includes a code example, verify it’s accurate.

After publishing

The previous version of the page is preserved in your Git history. If you need to revert a change, you can do so via Git or by contacting support.

Scheduled publishing

Mintlify does not currently support scheduled publishing from the web editor. If you need to publish at a specific time, you can push a commit to your Git repository at the desired time, which will trigger a deployment automatically.