# Collaborate in the editor (/editor/collaborate)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 1853 · updated: 2026-09-23 -->
Related: [How to use the editor](/editor/tutorial.md), [Create and edit pages](/editor/pages.md), [Publish changes](/editor/publish.md), [Review changes](/editor/review.md), [Ask agent](/editor/agent.md), [Editor settings for AI and publishing](/editor/settings.md)

Work with your team on a page by commenting on it, suggesting changes to it, or editing it together at the same time.

## Comments [#comments]

<Info>
  All [roles](/dashboard/roles) can comment, reply, and resolve threads.
</Info>

Comments let you leave feedback on specific text without editing the content.

**Comments never reach your repository.** They are only in the editor and are never included in the published site or committed to Git. If your branch has an open pull request, Mintlify adds a summary of unresolved threads to the pull request description, with a link back to each comment. The summary updates as threads change.

To add a comment, highlight text and click the <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 20.5C19.1328 20.5 22 16.4706 22 11.5C22 6.52944 20.1328 2.5 12 2.5C4.13281 2.5 2 6.52944 2 11.5C2 13.5712 2.37034 15.4791 3.37161 17C4.63281 19 3.99253 20.8333 3 21.5C4.61547 21.5 5.70211 20.9858 6.39239 20.4766C6.88252 20.115 7.50688 19.9364 8.0984 20.0815C9.20689 20.3533 10.4991 20.5 12 20.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12.1248 11.5H11.9998M16.125 11.5H16M8.125 11.5H8M12.2498 11.5C12.2498 11.6381 12.1379 11.75 11.9998 11.75C11.8618 11.75 11.7498 11.6381 11.7498 11.5C11.7498 11.3619 11.8618 11.25 11.9998 11.25C12.1379 11.25 12.2498 11.3619 12.2498 11.5ZM16.25 11.5C16.25 11.6381 16.1381 11.75 16 11.75C15.8619 11.75 15.75 11.6381 15.75 11.5C15.75 11.3619 15.8619 11.25 16 11.25C16.1381 11.25 16.25 11.3619 16.25 11.5ZM8.25 11.5C8.25 11.6381 8.13807 11.75 8 11.75C7.86193 11.75 7.75 11.6381 7.75 11.5C7.75 11.3619 7.86193 11.25 8 11.25C8.13807 11.25 8.25 11.3619 8.25 11.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **Comment** icon in the toolbar or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (Windows).

<Frame>
  <img src="/_assets/5f3a7d200ec813d19b910c5e46c4b6748fc574909296ae1929b652275925fbc8" alt="The comment button in the floating toolbar above selected text in the editor." className="dark:hidden" />

  <img src="/_assets/ebcb9c5b53a3a0a99e26de42e148addddfa55c4eb0079ce2259788e8fd216d6d" alt="The comment button in the floating toolbar above selected text in the editor." className="hidden dark:block" />
</Frame>

Type `@` to mention a teammate in a comment. They must be a member of your organization who has accepted their invitation. When you mention a teammate in a comment, they receive an email notification. Manage which comment and suggestion emails you receive from the [Notifications](/dashboard/notifications) page of your dashboard.

Comment threads appear in both visual and source mode. In source mode, you can read, reply to, and resolve existing threads, but starting a new comment requires visual mode.

To see every thread on the current page:

1. Click <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** in the top-right of the page.
2. Click **Comments**.

React to a comment to acknowledge it without replying. Hover over a comment, click the **Add reaction** button, and choose an emoji. Reacting to someone else's comment notifies the comment's author.

To edit or delete a comment you wrote, click **More actions** on the comment. You can only edit and delete your own comments. Deleting the first comment in a thread deletes the entire thread.

## Suggestions [#suggestions]

Suggestions propose a change while leaving the current content in place, so a teammate can accept or reject it.

Editors and admins can accept or reject any suggestion. Viewers cannot.

To make a suggestion, highlight text and click **Switch to suggesting** in the toolbar, or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd> (Windows). In suggesting mode, a **Suggesting** label appears in the top bar, and your deletions and insertions appear as highlighted text rather than edits. Click the label to go back to editing. Pending suggestions appear beside the page and in the comments panel.

<Note>
  [Viewers](/dashboard/roles) are always in suggesting mode. Suggesting mode activates automatically when a viewer opens the editor so that they can propose changes without editing content directly.
</Note>

Click a highlighted suggestion, then click **Accept suggestion** or **Reject suggestion**. Either choice resolves the suggestion thread. An accepted change becomes part of your current branch and goes live the next time you [publish](/editor/publish).

## Ask the Mintlify agent [#ask-the-mintlify-agent]

Mention `@mintlify` in a comment, suggestion, or reply to ask the [editor agent](/editor/agent) about the current page. The agent runs in the background with the page, thread, and branch as context, then posts its answer as a reply in the same thread.

```text
@mintlify does this endpoint support pagination?
@mintlify are there any pages that contradict this?
```

The agent runs read-only when replying to comments. It can search your docs, read pages, fetch web content, and load skills, but it cannot edit content, create suggestions, or publish. To make changes, open the [editor agent](/editor/agent) directly.

Mentions work on private pages for members who already have access.

## Real-time editing [#real-time-editing]

When multiple people open the same page on the same branch, they edit together. Each person's cursor and edits are visible to everyone, with avatars in the toolbar.

Real-time editing works in both visual mode and source mode. You can edit the MDX in source mode while a teammate works in visual mode on the same page. Their cursor and selection appear in your editor, and yours appear in theirs, including in the title and description fields.

* Changes from all collaborators merge automatically. Two people editing the same section won't create conflicts.
* Undo only affects your own edits.
* If you lose your connection, edits save locally and sync when you reconnect.
* In source mode, invalid MDX or frontmatter YAML stays local to you until you fix it. Teammates only receive valid content, and invalid MDX [blocks publishing](/editor/publish#invalid-mdx-blocks-publishing) until it's repaired.

When the [Mintlify agent](/agent) edits a page through the API or MCP, it appears like any other collaborator, with an avatar and a live cursor at its most recent edit. The cursor clears when the agent finishes.