Comments & @mentions
Every document has a Comments section at the bottom. Anyone who can see the document can join the discussion — comments follow the document’s access rules, so a private space’s comments stay private to its members.
Commenting
Section titled “Commenting”Type in the composer and press Comment. Plain text with line breaks; comments are capped at 4,000 characters. You can delete your own comments at any time (the thread shows a “removed” placeholder so replies keep their context).
Mentioning someone
Section titled “Mentioning someone”Type @ followed by a few letters of a teammate’s name and pick them from
the autocomplete. When you post, each mentioned person is notified twice:
- Email — with the comment text and a link straight to the document (sent only if they have notification emails turned on under Manage account → Notifications).
- Notification inbox — the bell in the sidebar, with a link straight to the comment thread.
Everyone else who has commented on the document also gets an inbox notification about the new comment (mentioned people just get the more specific mention instead), so threads don’t go quiet unnoticed.
Mentioning yourself doesn’t notify anyone, and the “Will notify” line under the composer shows exactly who will hear about your comment before you post it.
Moderation (admins)
Section titled “Moderation (admins)”Admins can remove any comment — the thread keeps a “removed by an admin” placeholder and the removed text is never shown again. Every comment creation and removal is recorded in the audit log.
Workspace controls (admins)
Section titled “Workspace controls (admins)”Under Settings → Workspace → Comments:
- Allow comments on documents — the workspace-wide switch. Turning it off hides all comment threads and blocks new comments immediately; nothing is deleted, and turning it back on restores every thread intact.
- Restricted words — a list (one per line or comma-separated, case-insensitive) of words or phrases that comments may not contain. A comment with a restricted term is rejected before it’s saved, and the author is told which term to rephrase. Single words match whole words only (“ban” doesn’t flag “banana”); multi-word phrases match anywhere.
