# Comment on pages in the editor (/editor/comments)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1125 · updated: 2026-07-30 -->
Related: [How to use the editor](/editor/tutorial.md), [Git essentials for the editor](/editor/git-essentials.md), [Create and edit pages](/editor/pages.md), [Organize navigation](/editor/navigation.md), [Live preview](/editor/live-preview.md), [Branching and publishing](/editor/branching-and-publishing.md)

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 [#add-a-comment]

1. Highlight the text you want to comment on.
2. 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.
3. Type your comment and press <kbd>Enter</kbd> to submit.

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

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

## Reply to a comment [#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="/_assets/25b956430d1e2ce298eebe3307a91a72183cc10258a5bb0447a7a4e4d90daa61" alt="A comment thread opened in the web editor and two comment threads in the sidebar." className="block dark:hidden" />

  <img src="/_assets/da3ad40a54c20d295a82a7266f09167d82898b2715d8fa89666ec8133a3888da" alt="A comment thread opened in the web editor and two comment threads in the sidebar." className="hidden dark:block" />
</Frame>

## Mention a teammate [#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 [#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="/_assets/221e77d35235fc5dad1a89d166176ab302606534b04a17a348b81a1dd8cecab1" alt="A comment thread opened in the web editor with the checkmark icon to resolve the thread highlighted." className="block dark:hidden" />

  <img src="/_assets/900bf2fe0b44327744b4f82a275ce55745fbdbf0824caf36e88bd48a660a1084" alt="A comment thread opened in the web editor with the checkmark icon to resolve the thread highlighted." className="hidden dark:block" />
</Frame>

## Delete a comment [#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.