mintlify__docs/editor/publish.mdx

---
title: "Publish changes in the web editor"
sidebarTitle: "Publish"
description: "Save drafts, stage changes, and publish updates to your live documentation site from the Mintlify web editor with one-click deployment."
keywords: ["editor", "publish", "changes", "branches", "pull requests"]
---

## 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.

<Tip>
  When you create a pull request from the editor, the Mintlify agent generates a title and description based on your changes. You can edit the generated title and description before creating the pull request.
</Tip>

**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 |
|-------------|-------------------|------------------------------|
| <Tooltip headline="Deployment branch" tip="The branch that publishes to your live documentation site, typically 'main'.">Deployment branch</Tooltip> | None | Commits and deploys changes |
| Deployment branch | Pull requests required | Creates a pull request |
| <Tooltip headline="Feature branch" tip="An isolated branch where you work on updates before merging to your deployment branch.">Feature branch</Tooltip> | None | Merges changes to deployment branch and deploys changes |
| Feature branch | Pull requests required | Creates a pull request |

<Tip>
  Configure branch protection rules in your Git provider to require pull requests. See [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) in the GitHub docs or [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) in the GitLab docs.
</Tip>

## 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.

<Frame caption="Changes on a deployment branch.">
  <img src="/images/editor/toolbar-light.png" alt="Web editor toolbar showing one pending change." className="block dark:hidden" />
  <img src="/images/editor/toolbar-dark.png" alt="Web editor toolbar showing one pending change." className="hidden dark:block" />
</Frame>

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

<Frame caption="Changes on a feature branch.">
<img src="/images/editor/toolbar-branch-light.png" alt="Web editor toolbar showing one pending change and the Save in branch button on a feature branch." className="block dark:hidden" />
<img src="/images/editor/toolbar-branch-dark.png" alt="Web editor toolbar showing one pending change and the Save in branch button on a feature branch." className="hidden dark:block" />
</Frame>

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

## Review branch changes

When you work on a feature branch, the publish panel shows all file changes between your branch and the deployment branch under **Saved in branch**. This includes changes saved by you and any teammates working on the same branch.

Click a file in the list to open a diff view showing changes between the branch and published content. Documentation files open in a visual diff, and other file types open in a source diff. Use this to review the full scope of changes on a branch before publishing.

Files that can't display a diff, such as images or removed files, appear in the list but aren't clickable.

## 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.

<Note>
  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](https://dashboard.mintlify.com).
</Note>

## 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](https://dashboard.mintlify.com/settings/account). 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.