Commenting and @Mentioning Colleagues

Where comments live

Every document has a Comments panel on the right side. Comments are:

Threaded (replies nest under parents)
Searchable (across the tenant)
Tied to the document version (so you can see what version the comment was on)
Permission-respecting (only people with access to the document see comments)

Posting a comment

Open the document
Click Comments in the right sidebar
Type your comment in the box at the bottom
Click Post or press Ctrl+Enter

The comment is timestamped, authored, and visible to everyone with access to the document.

Mentioning a colleague

Type @ and start typing the colleague's name. Pick from the autocomplete list.

When the comment is posted:

The mentioned user gets a notification (in-app + email)
The mention is highlighted in the comment thread
The mentioned user can click through to the document directly

You can mention multiple people in one comment.

Mentioning a whole group

You can also mention groups:

@HR — everyone in the HR department
@FinanceManagers — everyone with the FinanceManager role
@workspace — every member of the current project workspace

Use sparingly. Bulk mentions generate bulk notifications.

Resolving threads

When a comment thread has run its course:

Click Resolve on the thread
The thread is collapsed and marked resolved
The audit log captures who resolved it

Resolved threads remain visible (click to expand) — they're not deleted.

Comments as decisions

Comments are an excellent place to capture decisions — particularly when those decisions might be questioned later. “Approving this exception because [reason]” creates a permanent, searchable record.