Articles on: Rooms

Comments, mentions & threads

Comments are how participants discuss specific parts of a room without leaving for email. They live in the room's conversation panel, and any comment can be linked to a section so it shows up right where the discussion belongs.


Where comments live


Everything happens in one panel, opened from the Comments button in the room's top bar (between Notifications and Share). The button carries an unread badge (capped at 9+) that pulses when there is new activity.


There is no floating comments launcher in the bottom-right corner — that spot belongs to the Ask AI launcher.


Room top bar with the Comments button and its unread badge


The panel lists every thread in the room (search with Search conversations...). Each thread keeps a conversation together — a section discussion, a question about an action, a general topic — and is titled from its subject, the linked section, or New Conversation.


Writing a comment


  1. Click Comments in the top bar.
  2. Open an existing thread, or start a new one: fill the To: row (who should read it), optionally a Subject:, then type in Write a message...
  3. Press Enter to send (Shift+Enter for a new line).


The composer is the same email-style composer used for messages — recipients, attachments and privacy are described in Messages.


Linking a comment to a section


Instead of pointing at a pixel, you attach a comment to a whole section:


  1. In the composer toolbar, click the Link a section chip (tooltip: Link this message to a section of the room). In an open thread, the same chip reads Link this conversation to a section of the room.
  2. The chip switches to Click a section… and the room dims. Hover to highlight a section, then click it. Press Esc to cancel.
  3. The comment is pinned to that section's right margin.


What pins look like


  • Each comment linked to a section shows as a pill in the section's right margin: the author's initials, a message icon and the reply count.
  • The pill of the thread you're viewing is highlighted; while you're composing, an icon-only New comment pill marks the target.
  • Sections with no comments show nothing — no hover icons, no empty markers.
  • Click a pill to open its thread in the panel.


A section with two comment pills in its right margin, one active


Comments inside an action


Open any step, task or subtask: its details popup has its own thread, with the same composer. See Steps widget.


Reply, edit, delete


  • Reply — open a thread → write a reply (Write a reply...). You can adjust the reply's recipients in its To: row.
  • Edit — you can edit comments you authored (Edit message...). You can't edit anyone else's.
  • Delete — same rule: only your own.


Mentioning someone


Type @ and start typing a name. Pick from the autocomplete list.


Mentions notify the tagged person (email + in-app, per their notification settings).


Good uses:

  • @Sarah can you clarify the pricing here?
  • @Legal would love your take on the MSA section
  • @buyer-champion thoughts on this timeline?


Mentioning someone who isn't in the room


If the person you mention isn't a participant yet, Katalyz asks Invite {name}? — "They aren't in this room yet. Invite them so they can see your comment." (or "N people you mentioned aren't in this room yet…" for several). Cancel posts nothing; Next opens the Share modal pre-filled with their email so you can invite them and post in one go.


Making a comment private


Every comment is visible to everyone in the room by default. To restrict it:


  1. Add the people who should see it in the To: row.
  2. Click Make private in the composer toolbar. The label switches to Private and the hint reads Only {first name}, Only {A} and {B} or Only {A} +{n}.
  3. Send.


Hover the toggle to read what it does: "Anyone in the room can see this — click to restrict it to the recipients above" ↔ "Only the recipients above will see this — click to open it to the room." Privacy is set per comment; you can keep a thread open and make a single reply private. See Controlling visibility.


Who can comment


Everyone with access to the room can comment except Viewers, who are read-only — Owners, Editors and Commenters can all comment, whether they're org members or external participants. A guest who isn't signed in yet is asked to do so before posting — see Choosing the right access setting.


Notifications


By default:

  • You're notified when @-mentioned
  • You're notified of replies in threads you posted in
  • The Owner is notified of every comment on the room (per Room roles)
  • Action assignees are notified of every comment posted in the thread of an action they're assigned to (step / task / subtask)


Inside the room, a new comment also pops up as a toast under the top bar; several of them pile up into one card with a count. See Managing your notifications.


Updated on: 04/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!