Comments.

Select a chunk of code, SQL, or prose, hit Cmd+Shift+M, and leave a thread.

Where comments attach

Comments anchor to a selection inside a cell, not the whole cell. The selection can be:

  • A range of text inside a markdown cell.
  • A range of lines (or characters) in a code or SQL cell.
  • A specific column or row in a result table.
  • A region of a chart (drag to select).

The thread sits in the right gutter next to its anchor. Click an indicator to expand the thread; click anywhere else to collapse.

A code cell with two comment indicators in the right gutter and one expanded thread showing replies./docs-images/collaboration/comment-gutter.png
Comments live in the right gutter. Click an indicator to expand.

Mentions

Type @ in a comment to mention a collaborator. The autocomplete lists everyone on the project. Mentioned users get an in-app notification (bell icon, top-right) and an email — preferences in Settings → Notifications.

Mentions resolve to a stable user id, so they survive name changes and (eventually) team-membership changes.

@anna can you double-check the join condition on line 12? I think
this should be LEFT JOIN, not INNER. Otherwise we miss customers
who haven't placed an order yet.

Resolving threads

Hit Resolve on a thread when the conversation has run its course. The thread collapses and hides from the default view; the indicator turns gray. Use the Resolved filter at the top of the comments panel to bring them back.

Resolving doesn't delete — anyone can re-open a thread to add a follow-up. Deletion is a separate action on each individual reply (your own only) or on the whole thread (by the original author or a project admin).

Tip

Use the comments panel (Cmd+Shift+P → "Comments") to see every open thread across the notebook in one list. Filter by mentioned user, by author, or by unresolved.

Surviving edits

Comment anchors track edits as best they can. If you tweak the code around a comment, the anchor updates to follow. If the lines the anchor pointed at get deleted, the comment becomes orphaned — it still shows in the comments panel with a small icon, and you can re-attach it to a new selection or archive it.

Deleting the whole cell archives the thread but doesn't delete it. Restore it from the comments panel under the "Archived" filter if you bring the cell back.

The comments panel listing all open, resolved, and archived comments with filters at the top./docs-images/collaboration/comments-panel.png
The comments panel — one list of everything that needs attention.

Notifications

  • You get notified when someone mentions you, replies to a thread you started, or replies to a thread you commented on.
  • Project admins get notified on every new top-level comment. Toggleable per project.
  • Email digests bundle non-mention notifications into one message every few hours.

Comments in published views

Comments don't appear in published notebooks or dashboards. They're collaborator-only by design — the share viewer sees the rendered output, not the back-and-forth that produced it.

Up next: Publishing and Permissions. Back to the Collaboration overview.