Skip to main content
Comments and @mentions turn a document into a live conversation space — your team can ask questions, leave feedback, and flag items for review without ever leaving the page. Every comment anchors to the exact text selection it references, so context is always clear. Threads keep discussions organized, and emoji reactions let you acknowledge feedback without adding noise.

​
Adding a comment

1

Select the text you want to comment on

Highlight any range of text in the document. A small toolbar appears above your selection.
2

Click the comment icon

Click the speech bubble icon in the selection toolbar. A comment panel opens on the right side of the editor, anchored to your selection.
3

Write and submit your comment

Type your comment in the input field. Press Enter (or click Post) to save it. The selected text is highlighted in yellow to indicate an active comment thread.
Before publishing a document, leave a comment on the opening paragraph asking a specific reviewer to check it. This turns your document into a lightweight review workflow — no separate review tool needed.

​
Replying in threads

Every comment automatically becomes a thread. To reply:
  1. Click on the highlighted text (or open the Comments panel from the top-right toolbar).
  2. Find the comment thread you want to reply to.
  3. Click Reply, type your message, and press Enter.
Threads keep all discussion about a specific text selection in one place, making it easy to follow a conversation from start to finish.

​
Reacting with emoji

To react to any comment or reply with an emoji:
  1. Hover over the comment.
  2. Click the smiley face icon that appears to the right.
  3. Pick an emoji from the picker.
Reactions are visible to everyone who can view the document and are a low-friction way to acknowledge a point without adding a reply.

​
@mentioning a teammate

Use @mentions inside any comment or reply to notify a specific person.
1

Open a comment or reply

Start a new comment or click Reply on an existing thread.
2

Type @ followed by a name

Type @ and begin typing your teammate’s name or username. A dropdown list of matching workspace members appears.
3

Select the teammate

Click the correct name in the dropdown. Their handle appears highlighted in the comment input.
4

Post the comment

Submit the comment as usual. The mentioned teammate receives an in-app notification and an email (based on their notification preferences) with a direct link to the comment thread.
You can @mention multiple teammates in a single comment. Each person receives their own notification.

​
Resolving a comment

Once a discussion is complete, resolve the thread to clean up the document view.
  1. Open the comment thread.
  2. Click Resolve (the checkmark icon) in the top-right of the thread panel.
  3. The yellow highlight disappears from the text and the thread moves to the Resolved section of the Comments panel.
Resolving a comment does not delete it — the full thread is preserved and searchable.

​
Reopening a resolved comment

If a resolved issue comes back up, you can reopen the thread:
  1. Open the Comments panel from the top-right toolbar.
  2. Switch to the Resolved tab.
  3. Find the thread and click Reopen. The comment becomes active again and the text highlight is restored.

​
FAQs

Currently, inline comments attach to text selections only. To discuss an image or other block, add a comment to the text immediately before or after the block, or use a general document comment by clicking Add comment in the Comments panel without selecting text.
No. @mentions only surface workspace members. If you want to notify an external collaborator, share the document link with them directly and let them know to check the comments section.
Yes. In-app notifications appear immediately. Email notifications are batched and sent within a few minutes, depending on the recipient’s notification settings.
Yes. Hover over your own comment and click the … menu to edit or delete it. Deleting a comment removes it permanently, including all replies in that thread.