From 97a4e6287a857a33969d51a7cb48c88bcf5b0e40 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 22 Oct 2026 09:15:46 +0000 Subject: [PATCH] docs: explain @mintlify edits from comment threads --- editor/collaborate.mdx | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx index c9f72ecfd..5a107753e 100644 --- a/editor/collaborate.mdx +++ b/editor/collaborate.mdx @@ -83,7 +83,15 @@ Mention `@mintlify` in a comment, suggestion, or reply to ask the [editor agent] To ask about specific text, highlight it and click **Ask Mintlify** in the toolbar. Mintlify opens a new comment on the highlighted text with `@mintlify` already added, so you only need to type your question. -The agent runs read-only when replying to comments. It can read pages and their open comments, view images, search and fetch web content, and search Mintlify's documentation, but it can't edit content, create suggestions, or publish. To make changes, open the [editor agent](/editor/agent) directly. +If you can edit content, you can also ask the agent to change the page from the thread. Admins and editors can edit content. Without [role-based access control](/dashboard/roles), every member can. + +```text +@mintlify fix the typo in this sentence +``` + +The agent edits the page on the thread's branch only when your comment explicitly asks for a change. For questions, feedback, or suggestions, it answers and offers to make the change instead. When it edits the page, its reply says what it changed. The agent doesn't publish, so review its changes and [publish](/editor/publish) them yourself. + +For [viewers](/dashboard/roles), the agent replies read-only. It can read pages and their open comments, view images, search and fetch web content, and search Mintlify's documentation, but it can't edit content. Mentions work on private pages for members who already have access.