> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use the editor

> Step-by-step walkthrough of the Mintlify editor: create a branch, edit pages, share a preview deployment for review, and publish your documentation changes.

This tutorial walks you through a complete content update using the editor. You'll create a branch, make a change, share a preview for review, and publish your changes.

<Steps>
  <Step title="Create a branch">
    A branch is a temporary copy of your content. It's where you make your changes without affecting your live site.

    Think of branches like drafts. You can merge them into your live site or safely discard them if you choose not to make the changes.

    Working on a branch keeps your edits separate from your live site until you're ready to share the content with your users.

    1. In the editor toolbar, click the branch name (usually `main`).

           <Frame>
             <img src="https://mintcdn.com/mintlify/i7HF0rh5FCMSySpX/images/editor/create-branch-light.png?fit=max&auto=format&n=i7HF0rh5FCMSySpX&q=85&s=de95758efbc36fa1744981f990941e90" alt="Branch name emphasized in the editor toolbar." className="block dark:hidden" width="2458" height="114" data-path="images/editor/create-branch-light.png" />

             <img src="https://mintcdn.com/mintlify/i7HF0rh5FCMSySpX/images/editor/create-branch-dark.png?fit=max&auto=format&n=i7HF0rh5FCMSySpX&q=85&s=38f977f10df9384b268d3982f1bd5535" alt="Branch name emphasized in the editor toolbar." className="hidden dark:block" width="2456" height="114" data-path="images/editor/create-branch-dark.png" />
           </Frame>
    2. Click **Create new branch**.
    3. Enter a name that describes your change, like `update-quickstart`.
    4. Click **Create branch**.

    The editor switches to your new branch. Any changes you make are only on the branch. They only appear on your live site when you complete the publishing process.
  </Step>

  <Step title="Make your changes">
    Edit an existing page or create a new one.

    **To edit a page**: Click it in the navigation sidebar to open it. Type directly in the editor to add content. Press <kbd>/</kbd> to insert components, images, or other content.

    **To create a page**: Click the <Icon icon="plus" /> plus button next to the navigation group where you want to add the page, then click **Add a page** and enter a filename.

    <Frame>
      <img src="https://mintcdn.com/mintlify/i7HF0rh5FCMSySpX/images/editor/add-page-light.png?fit=max&auto=format&n=i7HF0rh5FCMSySpX&q=85&s=5283f9de897cbf3cf87a3cac7dca935b" alt="The add page menu opened beside a group in the editor." className="block dark:hidden" width="1812" height="1148" data-path="images/editor/add-page-light.png" />

      <img src="https://mintcdn.com/mintlify/i7HF0rh5FCMSySpX/images/editor/add-page-dark.png?fit=max&auto=format&n=i7HF0rh5FCMSySpX&q=85&s=8a2766dfd62e1f7cfc82fbcfb2fb601f" alt="The add page menu opened beside a group in the editor." className="hidden dark:block" width="1812" height="1148" data-path="images/editor/add-page-dark.png" />
    </Frame>
  </Step>

  <Step title="Publish your branch">
    To review your changes, you must create a pull request. A pull request is a proposal to merge your changes into the main branch that builds your site.

    When you publish your branch, you make it available for review by your team. The changes only appear on your live site if you merge the pull request.

    1. Click **Publish** in the toolbar to open the publish menu.

           <Frame>
             <img src="https://mintcdn.com/mintlify/i7HF0rh5FCMSySpX/images/editor/publish-menu-light.png?fit=max&auto=format&n=i7HF0rh5FCMSySpX&q=85&s=b1b35fa88340dae93b38647a18933229" alt="The publish menu opened in the editor toolbar." className="block dark:hidden" width="1192" height="534" data-path="images/editor/publish-menu-light.png" />

             <img src="https://mintcdn.com/mintlify/i7HF0rh5FCMSySpX/images/editor/publish-menu-dark.png?fit=max&auto=format&n=i7HF0rh5FCMSySpX&q=85&s=e2eab84933b03b41e2a88a911ecdd31a" alt="The publish menu opened in the editor toolbar." className="hidden dark:block" width="1192" height="534" data-path="images/editor/publish-menu-dark.png" />
           </Frame>
    2. Optionally, click any changed file in the list to view and compare your edits against the published version.
    3. Click **Save in branch** to save all changes on your branch.
    4. Click **Create pull request**. Add a title and description, then click **Publish pull request**.
    5. Continue to GitHub to view your pull request and review your changes.
  </Step>

  <Step title="Review your changes">
    Share your pull request with your team to review your changes.
  </Step>

  <Step title="Merge your pull request">
    After your team approves your changes, merge your pull request into the main branch. Your changes deploy to your live site.
  </Step>
</Steps>


## Related topics

- [Git concepts for documentation](/docs/guides/git-concepts.md)
- [How to use images, screenshots, and videos in documentation](/docs/guides/media.md)
- [Editor overview](/docs/editor/index.md)