Skip to content

Editor page links #3098

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 2 commits into from
Feb 3, 2026
Merged

Editor page links #3098

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f273328
add section on sharing editor links
ethanpalm Feb 3, 2026
7631c89
disambiguate usage of preview deployments versus editor links
ethanpalm Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 23 additions & 3 deletions editor/collaborate.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.
Expand Down Expand Up @@ -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

Expand All @@ -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 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.

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.

<Tip>
When you share a page, tell people which branch you're working on so they can confirm they view the correct version.
</Tip>