Publish changes from the editor to your live site. Branches and protection rules determine what happens when you publish.
Your changes save automatically as you edit, but they only reach your live site when you publish them. What happens when you publish depends on which branch you work on and whether that branch requires pull requests.
If you don’t see a Publish button, your deployment has auto publish turned on and your edits go live automatically. If you don’t see a branch selector, show the branch selector.
Publish: Commits and deploys your changes to your live site immediately.
Save in branch: Commits your changes to the feature branch without merging to your deployment branch.
Create branch: Moves your pending changes to a new feature branch when you’re on a protected deployment branch.
Create pull request: Opens a pull request targeting your deployment branch.
Only one publish can happen at a time per branch. If a teammate publishes to the same branch, wait for their publish to complete before trying again.
Your live site updates after Mintlify builds and deploys your changes. This typically takes 30 seconds to a few minutes. Check the deployment status on your dashboard.
Edit directly on your deployment branch if you do not use a Git-based workflow. Create a branch if each change goes through review before it reaches your live site.To create a branch, click the branch name in the editor toolbar, select Create new branch, enter a name, then click Create branch.
Creating or switching branches while you have unpublished changes prompts you to bring those changes with you or leave them behind. Changes you leave behind stay on the original branch.
If your deployment branch has no branch protections, the editor hides the branch selector while you work on the deployment branch. To show it, click More options in the top bar, then turn on Branches. This preference applies only to you.The branch selector always appears when your repository requires pull requests or when you work on a feature branch.
Conflicts occur when your branch and the deployment branch have incompatible changes to the same files. For example, when you and a teammate edit the same lines or move a file to different locations.When someone pushes to your repository from outside the editor, the editor applies non-overlapping changes automatically. If a remote change and your edit affect the same part of a page, the editor highlights the conflict.The editor displays a warning when conflicts block publishing. Follow the prompts to choose which version of each conflicting section to keep.
Sign commits with your GitHub account by authorizing it in your account settings. Without authorization, the Mintlify GitHub App signs commits made in the editor.
If your deployment has auto publish turned on, the editor commits to your deployment branch shortly after you stop typing. The branch selector and Publish button are hidden. There is no pending state and no review step.Edits on feature branches created from the editor commit automatically either way, but they never publish unless you merge them into your deployment branch.
