Publish changes in the web editor

Save your work and publish changes to your documentation site.

Publishing workflows

The editor supports two workflows for publishing documentation updates. The workflow you use depends on your repository’s branch protection rules and the branch you work on.

• Create pull requests: If your repository has a branch protection rule that requires pull requests before changes can merge into your deployment branch, the editor creates a pull request when you publish changes.
• Publish directly: If your repository has no branch protection rules, your changes merge to the deployment branch and deploy immediately when you publish.

Branch type	Branch protection	Publishing workflow
Deployment branch	None	Commits and deploys changes
Deployment branch	Pull requests required	Creates a pull request
Feature branch	None	Merges changes to deployment branch and deploys changes
Feature branch	Pull requests required	Creates a pull request

Configure branch protection rules in your Git provider to require pull requests. See About protected branches in the GitHub docs or Protected branches in the GitLab docs.

Save changes

As you edit, the editor tracks your changes.

• New or deleted files.
• Content edits in pages.
• Navigation structure changes.
• Media uploads and organization.
• Configuration updates.

When you work on your deployment branch, changes automatically save.

When you work on a feature branch, save changes to the branch.

To discard changes, click Undo changes beside a filename in the files changed dropdown.

Review changes

Click a filename in the files changed dropdown to see what changed. The editor opens a diff view that highlights additions, deletions, and modifications so you can review your edits before publishing.

The diff view mode depends on your current editing mode:

• Visual diff: When you are in visual mode, the editor shows a rendered preview with colored markers in the gutter. Green markers indicate additions, red markers indicate deletions, and blue markers indicate modifications.
• Markdown diff: When you are in Markdown mode, the editor shows a side-by-side comparison of the raw source.

Use the mode toggle in the toolbar to switch between visual and Markdown diff views. Click the button next to the mode toggle to exit the diff view and return to editing.

Publish your changes

Click Publish in the toolbar. Depending on your workflow, your changes deploy immediately or create a pull request for you to merge in your Git provider. If you are on a feature branch, save your changes before publishing.

If there are no pending changes or a pull request for the current branch is already open, the Publish button is unclickable.

Your live documentation site updates after Mintlify builds and deploys your published changes. This typically takes 30 seconds to a few minutes. Check the deployment status of your changes on your dashboard.

Resolve conflicts

Conflicts occur when your branch and the deployment branch have incompatible changes to the same files.

What causes conflicts

Conflicts happen when you try to merge branches with incompatible changes to the same files.

• You and another team member edit the same lines in a file on different branches.
• You move, rename, or delete files on one branch and modify them differently on another branch.

Resolve conflicts

The editor displays warnings when conflicts prevent operations like publishing or switching branches. To resolve conflicts, follow the instructions in the editor to choose which changes to keep.

Commit signing

Sign commits with your GitHub account by authorizing it in your account settings. Without authorization, the Mintlify GitHub App signs commits made in the web editor.

Attributing commits to your account maintains an accurate history of who made changes to your documentation.