> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.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.

    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/adminroletesting-justin-client-exports/NEOZ7P71btyQDTB6/images/editor/create-branch-light.png?fit=max&auto=format&n=NEOZ7P71btyQDTB6&q=85&s=055c5f3a4ea28c127da50b038cc52d87" 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/adminroletesting-justin-client-exports/NEOZ7P71btyQDTB6/images/editor/create-branch-dark.png?fit=max&auto=format&n=NEOZ7P71btyQDTB6&q=85&s=5ad7518e7f4b6400ef4759c4e4698eba" 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/adminroletesting-justin-client-exports/NEOZ7P71btyQDTB6/images/editor/add-page-light.png?fit=max&auto=format&n=NEOZ7P71btyQDTB6&q=85&s=7b8dc8ddd12fcce4066541e617cd1337" 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/adminroletesting-justin-client-exports/NEOZ7P71btyQDTB6/images/editor/add-page-dark.png?fit=max&auto=format&n=NEOZ7P71btyQDTB6&q=85&s=637da399a427ce87b7dcae715cd404a3" 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/adminroletesting-justin-client-exports/NEOZ7P71btyQDTB6/images/editor/publish-menu-light.png?fit=max&auto=format&n=NEOZ7P71btyQDTB6&q=85&s=2ad5dbf4cef6768e19f4182360e6fe6c" 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/adminroletesting-justin-client-exports/NEOZ7P71btyQDTB6/images/editor/publish-menu-dark.png?fit=max&auto=format&n=NEOZ7P71btyQDTB6&q=85&s=a5fa0cda33d640913e1a0d754351da28" 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 the pull request is created, 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>