# Review changes (/editor/review)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1729 · updated: 2026-09-23 -->
Related: [How to use the editor](/editor/tutorial.md), [Create and edit pages](/editor/pages.md), [Publish changes](/editor/publish.md), [Collaborate in the editor](/editor/collaborate.md), [Ask agent](/editor/agent.md), [Editor settings for AI and publishing](/editor/settings.md)

Preview your changes before they reach your live site, request review on your pull request, and merge it from the editor.

## Live preview [#live-preview]

Live preview renders your site as you edit, with no build step. On the **Site** tab, click <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M18.8906 12.846C18.5371 14.189 16.8667 15.138 13.5257 17.0361C10.296 18.8709 8.6812 19.7884 7.37983 19.4196C6.8418 19.2671 6.35159 18.9776 5.95624 18.5787C5 17.6139 5 15.7426 5 12C5 8.2574 5 6.3861 5.95624 5.42132C6.35159 5.02245 6.8418 4.73288 7.37983 4.58042C8.6812 4.21165 10.296 5.12907 13.5257 6.96393C16.8667 8.86197 18.5371 9.811 18.8906 11.154C19.0365 11.7084 19.0365 12.2916 18.8906 12.846Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **Preview** in the top bar. The preview opens full screen. Click **Refresh preview** to reload it, or **Close preview** to return to the editor. To open the preview in a new browser tab instead, turn on [Open live preview in new tab](/editor/settings#appearance).

To edit site settings and see how they affect your content, click **Site settings** in the preview toolbar, then select a configuration section.

To open the [agent](/editor/agent) beside the preview, click **Ask agent** in the preview toolbar. Only editors and admins can use the agent in live previews.

<Note>
  Live preview is only available for public sites and sites protected by Mintlify authentication.
</Note>

## Preview deployments [#preview-deployments]

When your feature branch has a pull request, Mintlify builds a preview deployment: a temporary URL where your changes render exactly as they look when published. The preview rebuilds each time the editor commits new changes to the branch. The URL combines your project's subdomain and the branch name: `<subdomain>-<branch-name>.mintlify.site`. Find the exact URL in the pull request comment from the Mintlify bot.

Preview URLs are publicly accessible by default. To restrict access to members of your Mintlify organization, enable preview authentication in the **Previews** section of the [General](https://app.mintlify.com/settings/deployment/general) page in your dashboard. See [Restrict access to preview deployments](/deploy/preview-deployments#restrict-access-to-preview-deployments) for more information.

## Which preview to use [#which-preview-to-use]

| Feature          | Live preview                    | Preview deployment                |
| ---------------- | ------------------------------- | --------------------------------- |
| **Speed**        | Instant                         | Requires a build                  |
| **Access**       | Inside the editor               | Shareable URL                     |
| **Use when**     | Reviewing changes while editing | Sharing with your team for review |
| **Availability** | While the editor is open        | As long as the branch exists      |

## Share an editor link [#share-an-editor-link]

To point a teammate at a specific page on a branch, click <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** in the top-right of the page, then click **Copy link**. Anyone with access to your Mintlify organization can open the link in their own editor session.

## Review and merge pull requests [#review-and-merge-pull-requests]

When your branch has a pull request, the publish menu shows its changed files and review status, like **Draft in progress**, **Review required**, **Changes requested**, or **Approved**. Click **View request** to open the pull request in your Git provider.

1. Click **Publish** in the top bar, then click **Request review**. This marks the pull request ready for review.
2. Reviewers approve the pull request in your Git provider.
3. Click **Publish**, then click **Merge and publish**. The editor merges the pull request, deploys your changes, and switches you back to your deployment branch.

If Mintlify hosts your repository and approvals aren't required, the publish menu shows **Publish** instead, which merges and deploys in one step.

<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 help or [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) in the GitLab help.
</Tip>

### Compare changes before merging [#compare-changes-before-merging]

Click any changed file in the publish menu to open it in diff view against the published version. To leave diff view, click **Viewing changes** in the top bar or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (Windows). Visual mode shows a visual diff and source mode shows a text diff. Files that can't display a diff, such as images or deleted files, appear in the list but aren't clickable.

[Hidden pages](/organize/hidden-pages) that appear in the branch diff are openable from the publish menu, even though they don't appear in your site navigation.

### Pull request titles and descriptions [#pull-request-titles-and-descriptions]

The pull request title comes from your branch title.

If your branch has open comment threads, Mintlify adds a summary of them to the pull request description. See [Collaborate](/editor/collaborate#comments).

## Review an automation run [#review-an-automation-run]

When an [automation](/automations) opens a pull request, you can open the editor on the automation's branch:

* From a Slack notification or notification email, click **View changes**. The editor opens on the automation's branch in diff view, and the [agent](/editor/agent#continue-an-automation-run) opens alongside it with context on what the automation did.
* From the **Runs** tab on the Automations page in your dashboard, open a run's actions menu and select **Open in editor**.

To open the automation's preview deployment instead, click **Preview** on the run.