> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-c72b8cbe.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comment on pages in the editor

> Leave inline comments on pages in the editor to give feedback, ask questions, mention teammates, and resolve threads before you publish changes.

Comments let you and your team leave feedback on specific text in a page without editing the content. Use comments to ask questions, flag issues, or discuss changes before you publish them.

Comments live only inside the editor. They are never included in the published site or committed to your repository.

All [roles](/dashboard/roles)—viewers, editors, and admins—can leave and reply to comments. Only editors and admins can resolve comment threads.

If your branch has an open pull request, Mintlify adds a summary of unresolved comment threads to the pull request description. The summary lists the files with open comments, the first comment in each thread, and a link to navigate to the comment in the editor.

The summary updates when you add, resolve, or delete a comment.

## Add a comment

1. Highlight the text you want to comment on.
2. Click the <Icon icon="message-square-text" /> **Comment** icon in the toolbar.
3. Type your comment and press <kbd>Enter</kbd> to submit.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-c72b8cbe/MXdDGoF5w5k-aCqr/images/editor/comment-light.png?fit=max&auto=format&n=MXdDGoF5w5k-aCqr&q=85&s=ba543905bb060ab1788ee79d3474bb72" alt="The comment button in the floating toolbar above selected text in the web editor." className="block dark:hidden" width="1290" height="648" data-path="images/editor/comment-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-c72b8cbe/MXdDGoF5w5k-aCqr/images/editor/comment-dark.png?fit=max&auto=format&n=MXdDGoF5w5k-aCqr&q=85&s=9ca06aaf9ba9b2641f5b9dba1cc13edf" alt="The comment button in the floating toolbar above selected text in the web editor." className="hidden dark:block" width="1290" height="648" data-path="images/editor/comment-dark.png" />
</Frame>

## Reply to a comment

To open a comment thread, click the highlighted text or click the thread in the comment sidebar. Type your reply and press <kbd>Enter</kbd> to submit.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-c72b8cbe/MXdDGoF5w5k-aCqr/images/editor/reply-light.png?fit=max&auto=format&n=MXdDGoF5w5k-aCqr&q=85&s=cb72ad8f704f2a2e5d566c9d1e9c6451" alt="A comment thread opened in the web editor and two comment threads in the sidebar." className="block dark:hidden" width="2014" height="384" data-path="images/editor/reply-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-c72b8cbe/MXdDGoF5w5k-aCqr/images/editor/reply-dark.png?fit=max&auto=format&n=MXdDGoF5w5k-aCqr&q=85&s=7c3d7b104f397564dbef90526e6fd32f" alt="A comment thread opened in the web editor and two comment threads in the sidebar." className="hidden dark:block" width="2008" height="378" data-path="images/editor/reply-dark.png" />
</Frame>

## Mention a teammate

Type `@` in a comment or reply to mention a teammate. People must be a member of your organization for you to mention them.

Mentioned teammates receive an email notification.

## Resolve a comment

Editors and admins can resolve threads when a discussion is complete.

Click the checkmark icon to resolve a thread. Resolved threads are removed from the comment sidebar and the highlight is cleared from the page.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-c72b8cbe/MXdDGoF5w5k-aCqr/images/editor/resolve-light.png?fit=max&auto=format&n=MXdDGoF5w5k-aCqr&q=85&s=6c0687ad0ef54eee35bcddf1b5f04869" alt="A comment thread opened in the web editor with the checkmark icon to resolve the thread highlighted." className="block dark:hidden" width="870" height="324" data-path="images/editor/resolve-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-c72b8cbe/MXdDGoF5w5k-aCqr/images/editor/resolve-dark.png?fit=max&auto=format&n=MXdDGoF5w5k-aCqr&q=85&s=9760381d2b21d6734ec71dd33a4f74cf" alt="A comment thread opened in the web editor with the checkmark icon to resolve the thread highlighted." className="hidden dark:block" width="870" height="324" data-path="images/editor/resolve-dark.png" />
</Frame>

## Delete a comment

Click the trashcan icon beside a comment to delete it. Deleting the first comment in a thread deletes the entire thread.

You can delete your own comments. Admins can delete any comment.