> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Preview deployments

> Preview changes to your docs in a live deployment

<Info>
  Preview deployments are available on [Pro and Enterprise plans](https://mintlify.com/pricing?ref=preview-deployments).
</Info>

Preview deployments let you see how changes to your docs will look before merging to production. Each preview creates a shareable URL that updates automatically as you push new changes.

## Creating preview deployments

Preview deployments are created automatically through pull requests or manually from your dashboard.

### Automatic previews

When you create a pull request, the Mintlify bot automatically adds a link to view the preview deployment in your pull request. The preview updates each time you push new commits to the branch.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/zyJsbuZtXQKHf9Ui/images/previews/preview-deployment-light.png?fit=max&auto=format&n=zyJsbuZtXQKHf9Ui&q=85&s=4136751f5637420438c5be8c3f9e72c8" alt="Link to view deployment in the pull request timeline" className="block dark:hidden" width="1704" height="142" data-path="images/previews/preview-deployment-light.png" />

  <img src="https://mintcdn.com/omer-914cc1c6/zyJsbuZtXQKHf9Ui/images/previews/preview-deployment-dark.png?fit=max&auto=format&n=zyJsbuZtXQKHf9Ui&q=85&s=1c97ea88c87477a029e0e743aefbe947" alt="Link to view deployment in the pull request timeline" className="hidden dark:block" width="1704" height="142" data-path="images/previews/preview-deployment-dark.png" />
</Frame>

### Manual previews

You can manually create a preview for any branch.

1. Go to your [dashboard](https://dashboard.mintlify.com/).
2. Select **Previews**.
3. Select **Create preview**.
4. Enter your branch name.
5. Select **Create deployment**.

## Redeploying a preview

Redeploy a preview to refresh content or retry after a failed deployment.

1. Select the preview from your [dashboard](https://dashboard.mintlify.com/).
2. Select **Redeploy**.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/zyJsbuZtXQKHf9Ui/images/previews/redeploy-preview-light.png?fit=max&auto=format&n=zyJsbuZtXQKHf9Ui&q=85&s=8494d0b424028a765a07a86bea9fe7e2" alt="The Previews menu with the deploy button emphasized by an orange rectangle." className="block dark:hidden" width="2104" height="634" data-path="images/previews/redeploy-preview-light.png" />

  <img src="https://mintcdn.com/omer-914cc1c6/zyJsbuZtXQKHf9Ui/images/previews/redeploy-preview-dark.png?fit=max&auto=format&n=zyJsbuZtXQKHf9Ui&q=85&s=c1150e3074e088b22146a50ef0ff0a37" alt="The Previews menu with the deploy button emphasized by an orange rectangle." className="hidden dark:block" width="2104" height="634" data-path="images/previews/redeploy-preview-dark.png" />
</Frame>

## Sharing preview deployments

Preview deployments can be publicly accessible or restricted to authenticated users.

**Public access**: Preview URLs are publicly viewable by default. Share a preview link with anyone who needs to review your changes.

**Restricted access**: Enable preview deployment authentication to limit preview access to authenticated Mintlify users only. See [Authentication Setup](/authentication-personalization/authentication-setup) for more information.
