> ## Documentation Index
> Fetch the complete documentation index at: https://tomee-mintlify-a42fba9d.mintlify.site/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 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. You can merge a branch into your live site or safely discard it 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/tomee-mintlify-a42fba9d/k9T7mi6UvZbwG8Vt/images/editor/create-branch-light.png?fit=max&auto=format&n=k9T7mi6UvZbwG8Vt&q=85&s=586d539bf87cf675c82c39ba5830baab" alt="Branch name emphasized in the editor toolbar." className="block dark:hidden" width="2510" height="178" data-path="images/editor/create-branch-light.png" />

             <img src="https://mintcdn.com/tomee-mintlify-a42fba9d/k9T7mi6UvZbwG8Vt/images/editor/create-branch-dark.png?fit=max&auto=format&n=k9T7mi6UvZbwG8Vt&q=85&s=d8f3b2f40ca670f2f8367ce950a2db1b" alt="Branch name emphasized in the editor toolbar." className="hidden dark:block" width="2510" height="178" 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 if 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 the page name 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/tomee-mintlify-a42fba9d/k9T7mi6UvZbwG8Vt/images/editor/add-page-light.png?fit=max&auto=format&n=k9T7mi6UvZbwG8Vt&q=85&s=397ac38d436e5bb93867d930ac5281ad" 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/tomee-mintlify-a42fba9d/k9T7mi6UvZbwG8Vt/images/editor/add-page-dark.png?fit=max&auto=format&n=k9T7mi6UvZbwG8Vt&q=85&s=e4d7d8869aeef14146622d5b5d467dab" 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">
    When you're ready for review, create a pull request from your branch. A pull request is a proposal to merge your changes into the branch that builds your live site. Your changes only go live after someone approves and merges the pull request.

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

           <Frame>
             <img src="https://mintcdn.com/tomee-mintlify-a42fba9d/k9T7mi6UvZbwG8Vt/images/editor/publish-menu-light.png?fit=max&auto=format&n=k9T7mi6UvZbwG8Vt&q=85&s=2ab2622e4d5eec153b504ae8271a78e5" 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/tomee-mintlify-a42fba9d/k9T7mi6UvZbwG8Vt/images/editor/publish-menu-dark.png?fit=max&auto=format&n=k9T7mi6UvZbwG8Vt&q=85&s=9fc91a4ac2e3bd118aa17ac5033220b0" 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 **Create pull request**. Add a title and description, then click **Publish pull request**.

    <Note>
      You can also click **Save in branch** to commit your changes without opening a pull request yet. This is useful if you want to keep editing before requesting review.
    </Note>

    After you create the pull request, a preview deployment builds automatically. The publish menu shows the preview URL, a temporary link where your changes render exactly as they would on your live site. Share this URL with your reviewers.
  </Step>

  <Step title="Get your pull request approved">
    Share the pull request with your team. Reviewers can open the pull request in GitHub or GitLab to leave comments, request changes, or approve it.

    If a reviewer requests changes, make the edits in the editor on the same branch. Your updates push to the existing pull request automatically. You don't need to create a new one.

    When all required reviewers have approved, the pull request is ready to merge.
  </Step>

  <Step title="Merge and publish">
    With the pull request approved, click **Publish** in the toolbar to reopen the publish menu. The menu now shows the pull request status and an option to merge.

    Click **Merge and publish**. The editor merges the pull request and switches you back to your deployment branch. Mintlify builds and deploys your changes. Your live site updates in about 30 seconds to a few minutes.
  </Step>
</Steps>