Skip to content

Comment

Comments let you attach discussion or feedback to a range in the body of a notebook or report. You can also use @ mentions in the body or in comments. See Notification preferences for notification settings.

Whether you can comment follows the view permission of the target resource (notebook permissions, report permissions). While a notebook is locked, you can't edit it, but you can still comment.

Key features

Adding a comment

Prerequisite: you need view permission on the target notebook or report.

  1. Select the text or block range in the body that you want to comment on.
  2. From the menu that appears, select Add comment.
  3. Enter your comment and select Add.

A marker appears where existing comments are attached. Select Open comment to open the thread.

For each comment, you can do the following.

  • Edit / Delete (your own comments)
  • Add reaction
  • Resolve
  • Copy link (link to the thread)

Comment list

Open Comments in the right sidebar to see a list of comments on the current page. In reports, you can also open this from Comments in the header.

The list can be filtered as follows.

ViewDescription
OpenActive comments and comments with broken references.
ActiveUnresolved comments whose target range is still valid.
Broken referenceComments whose target range can no longer be referenced, for example because it was deleted.
ResolvedComments closed with Resolve.

Mentions

While typing in the body or in a comment, type @ to choose a workspace user from a list of candidates. Mentioned users receive a notification according to their notification preferences.

LocationNotification event (notebook)
Notebook bodyMention in notebook
Notebook commentMention in comment / Reply in comment

For comments on reports, the targets are Mention in comment / Reply in comment.

Comments in reports

You can comment on reports the same way as on notebooks. If Disable comments is turned on in the report settings, comments are unavailable for that report (see Report settings). It's off (comments available) by default.

Comments aren't available in signed embeds.