From f273328bcd5c9e0eed76b792157d1bd617093132 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 3 Feb 2026 15:01:26 -0800 Subject: [PATCH 1/2] add section on sharing editor links --- editor/collaborate.mdx | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx index 3a5ec180a..82bcfc311 100644 --- a/editor/collaborate.mdx +++ b/editor/collaborate.mdx @@ -1,8 +1,8 @@ --- title: "Collaborate in the web editor" sidebarTitle: "Collaborate" -description: "Work together on documentation with branches, pull requests, and preview deployments." -keywords: ["editor", "collaboration", "branches", "pull requests", "preview deployments"] +description: "Work together on documentation with branches, pull requests, preview deployments, and shareable editor links." +keywords: ["editor", "collaboration", "branches", "pull requests", "preview deployments", "share links"] --- Collaborate with your team on documentation using branch-based workflows, pull requests, and preview deployments. @@ -60,3 +60,23 @@ Share the preview deployment URL with team members to gather feedback. Previews ### Preview authentication Preview URLs are publicly accessible by default. Enable preview authentication in the [Add-ons](https://dashboard.mintlify.com/products/addons) page of your dashboard to restrict access to authenticated organization members. + +## Share editor links + +Share a direct link to a specific page in the editor to quickly share a page with your teammates. Editor links require organization access and are used to collaborate on updates. + +When you open a page, the editor saves the path in the URL. Copy the URL from your browser's address bar to share it with teammates who have access to the editor. + +The URL format is: + +``` +https://dashboard.mintlify.com/{org}/{project}/editor/{branch}?file={filepath} +``` + +For example, `https://dashboard.mintlify.com/acme/docs/editor/main?file=guides/quickstart.mdx` opens `quickstart.mdx` on the `main` branch. + +Anyone with access to your Mintlify organization can use the link to open the file directly in the editor. + + + When you share a page, tell people which branch you're working on so they can confirm they view the correct version. + From 7631c892b40a1832bd74b308d49a1d92cf3fa14f Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 3 Feb 2026 15:10:23 -0800 Subject: [PATCH 2/2] disambiguate usage of preview deployments versus editor links --- editor/collaborate.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx index 82bcfc311..eafeee267 100644 --- a/editor/collaborate.mdx +++ b/editor/collaborate.mdx @@ -40,7 +40,7 @@ Use pull requests to propose changes and collaborate with your team before mergi ## Preview deployments -Preview deployments create temporary URLs where you can see your changes before they go live. +Preview deployments create temporary URLs where you can see your rendered changes before they go live. Use preview deployments to gather feedback on how changes. ### Access preview deployments @@ -63,7 +63,7 @@ Preview URLs are publicly accessible by default. Enable preview authentication i ## Share editor links -Share a direct link to a specific page in the editor to quickly share a page with your teammates. Editor links require organization access and are used to collaborate on updates. +Share a direct link to a specific page in the editor with your teammates. Use editor links to collaborate on updates and make changes to pages. When you open a page, the editor saves the path in the URL. Copy the URL from your browser's address bar to share it with teammates who have access to the editor.