From ad9ecd711ca12137f77df8708e44e6e04a7b3269 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 27 Jan 2026 22:10:11 +0000
Subject: [PATCH 1/3] Update editor/live-preview.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
editor/live-preview.mdx | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/editor/live-preview.mdx b/editor/live-preview.mdx
index 909c8204d..304786cc5 100644
--- a/editor/live-preview.mdx
+++ b/editor/live-preview.mdx
@@ -4,13 +4,17 @@ description: "Preview your documentation site and see changes in real time as yo
keywords: ["preview"]
---
-Preview your documentation site in real time as you make changes in the web editor. Live previews show your site exactly as it appears when published, without creating a preview deployment.
+Preview your documentation site in real time as you make changes in the web editor. Live previews open in a separate browser window and show your site exactly as it appears when published, without creating a preview deployment.
-- **Content changes**: See new and edited pages.
-- **Configuration updates**: View color, theme, logo, and other changes instantly.
+- **Content changes**: See new and edited pages update instantly.
+- **Configuration updates**: View color, theme, logo, and other changes in real time.
- **Navigation structure**: Preview how navigation items appear in the sidebar and tables of contents.
- **Component changes**: See how components render with your content.
+
+ Live preview requires keeping both the editor and preview windows open. Changes sync automatically between windows as you edit.
+
+
## Live previews versus preview deployments
Both features let you preview changes before publishing, but serve different purposes.
From c5eef2b2c2953b396a44a0b245936c5fb76a1d3a Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 27 Jan 2026 22:10:18 +0000
Subject: [PATCH 2/3] Update editor/live-preview.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
editor/live-preview.mdx | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/editor/live-preview.mdx b/editor/live-preview.mdx
index 304786cc5..ddd014c8e 100644
--- a/editor/live-preview.mdx
+++ b/editor/live-preview.mdx
@@ -22,7 +22,7 @@ Both features let you preview changes before publishing, but serve different pur
| | Live preview | Preview deployment |
|---------|--------------|-------------------|
| **Speed** | Instant | Requires build time |
-| **Access** | In the editor | Shareable URL |
+| **Access** | Separate window (local only) | Shareable URL |
| **Use case** | View changes while editing | Share with team for review |
| **Availability** | While editor is open | Persists until closed |
From d11a340fe1a9f00b4f469f69d272cd09ca1dbca4 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 27 Jan 2026 22:10:28 +0000
Subject: [PATCH 3/3] Update editor/live-preview.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
editor/live-preview.mdx | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/editor/live-preview.mdx b/editor/live-preview.mdx
index ddd014c8e..1363e5bc5 100644
--- a/editor/live-preview.mdx
+++ b/editor/live-preview.mdx
@@ -30,7 +30,7 @@ Use live preview for immediate feedback as you work. Create preview deployments
## Enable live preview
-Click the button in the toolbar to open a live preview of your site in the editor.
+Click the button in the toolbar to open a live preview of your site in a new browser window.
button in the toolbar to open a live preview of
/>
+The preview window opens alongside your editor and updates automatically as you make changes. Keep both windows open to see your edits in real time.
+
- Live preview is only available for public documentation. If your documentation requires authentication, the editor displays a "Live preview unavailable" message.
+ Live preview is currently **local only** and requires keeping both the editor and preview windows open in the same browser session. For shareable previews that your team can access, [upgrade your plan](/deploy/preview-deployments) to use preview deployments.
+
+
+ Live preview is not available for documentation that requires authentication. If your documentation uses auth, the preview window will not display content.
+