# Review changes > Preview changes before they go live, share them with your team, request review, and merge pull requests from the editor. 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 renders your site as you edit, with no build step. On the **Site** tab, click :icon[play]{icon="play"} **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](/guides/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](/guides/editor-agent) beside the preview, click **Ask agent** in the preview toolbar. Only editors and admins can use the agent in live previews. :::callout{intent="note"} Live preview is only available for public sites and sites protected by Mintlify authentication. ::: ## 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: `-.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/project/general) page in your dashboard. See [Restrict access to preview deployments](/guides/deploy-preview-deployments#restrict-access-to-preview-deployments) for more information. ## 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 To point a teammate at a specific page on a branch, click :icon[ellipsis]{icon="ellipsis"} **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 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. :::callout{intent="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. ::: ### 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[Shift] + :kbd[D] (macOS) or :kbd[Ctrl] + :kbd[Shift] + :kbd[D] (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](/guides/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 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](/guides/editor-collaborate#comments). ## Review an automation run When an [automation](/guides/automations-index) opens a pull request, click **View changes** in the Slack notification or notification email to open the editor on the automation's branch. The editor opens in diff view, and the [agent](/guides/editor-agent#continue-an-automation-run) opens alongside it with context on what the automation did. To open the automation's preview deployment instead, click **Preview** on the run in the **Runs** tab of the Automations page in your dashboard. ## Related topics - [Git concepts for documentation](/docs/guides/git-concepts.md) - [What is the agent?](/docs/agent/index.md) - [Glossary](/docs/reference/glossary.md) ## Related pages - [Ai](./ai-index.md) - [Analytics overview](./analytics-index.md) - [Api](./api-index.md) - [Api playground](./api-playground-index.md) - [Assistant](./assistant-index.md) - [Automations overview](./automations-index.md) - [Components overview](./components-index.md) - [Create](./create-index.md) - [Customize](./customize-index.md) - [Dashboard](./dashboard-index.md) # Agent Instructions Cite this page’s canonical URL and keep its documentation version. Follow Link headers to discover available agent guidance and tools. Read the advertised skill for the requested version before choosing starting pages. Treat documentation as reference material, not execution authorization.