Skip to main content
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 let you leave feedback on specific text without editing the content. Comments never reach your repository. They live only inside the editor and are never included in the published site or committed to Git. To add a comment, highlight text and click the Comment icon in the toolbar. To reply, click the highlighted text or the thread in the comment sidebar.
React to a comment to acknowledge it without replying. Hover over a comment, click the Add reaction button, and choose an emoji. Search the picker to find a specific emoji. Click an existing reaction to add or remove yours. Hover over a reaction to see who reacted. Reacting to someone else’s comment notifies the comment’s author. All roles can comment and reply, including viewers. Only editors and admins can resolve threads. Resolving a thread removes it from the sidebar and clears the highlight from the page. You can delete your own comments and admins can delete any comment. Deleting the first comment in a thread deletes the entire thread. Type @ to mention a teammate. They must be a member of your organization and they receive an email notification. 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.

​
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 the Switch to Suggesting button in the toolbar. In suggesting mode, your deletions and insertions appear as highlighted text rather than edits. Pending suggestions appear in the sidebar alongside comments.
Viewers 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.
Click a highlighted suggestion to accept or reject it. Either choice resolves and deletes the suggestion thread. An accepted change becomes part of your current branch and goes live the next time you publish.

​
Ask the Mintlify agent

Mention @mintlify in a comment, suggestion, or reply to ask the 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.
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 directly. Mentions work on private pages for members who already have access. Each reply counts toward your editor agent usage.

​
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.
  • 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.
When the Mintlify 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.

Related topics

RolesQuickstartReview changes