Comment and annotate in a notebook

You can comment on content within a notebook to discuss and review work. Commenting allows your team to consistently capture feedback and knowledge and reliably track conversations that lead to decisions.

Contributors and viewers can add, annotated, edit, and delete comments in any notebook to which they have access.

Comment on text content in a notebook

You can comment on any content in a notebook and you can mention other users in your organization in comments by typing ‘@’ followed by their name.

  1. Hover your cursor over any area that contains text to reveal the Leave a comment icon on the right side of the page.
  2. Click the Leave a comment icon to open the right sidebar. The block that you are commenting on is highlighted.
  3. Type in the comment box to reveal the comment button.
  4. Click Comment or use the keyboard shortcut to post the completed comment.

Tip: You can submit your comments using the keyboard shortcut +Enter or Ctrl+Enter.

Comment on images, and design content added from plugins

You can also leave feedback about images or the Figma and Sketch frames, artboards, elements, and symbols added to a notebook. Commenting in the notebook keeps your discussions and decisions together in one space.

  1. Click on any design item or image to select what you want to comment on, then click the frame again to enter the item detail view.
  2. Enter your comments in the comment box on the right side of this screen.
  3. Click Comment or use the keyboard shortcut to post the comment.

Annotate a comment

You can add an annotation to an image or an element that has been inserted into a notebook from your design tool to call out the specific item that you are commenting on. This allows your teammates to quickly and easily locate the elements that you want to discuss.

Tip: Click on the number next to the user's name on an annotated comment in the right panel to select the corresponding annotation.  Similarly, click on an annotation on the preview panel to highlight the comment in the right panel.

To add an annotation to a notebook:

  1. Click on any design item or image to select what you want to comment on.
  2. Click the frame again to enter the item detail view.
  3. In the right panel, click Annotate or use the keyboard shortcut (a) to start annotating.
  4. Click and drag inside the bounded area to create an annotation box. Use the handles to move or resize the annotation box to the desired size and location. The number on the annotation matches the number on the comment.

  5. Type in the text box to add your comments about the annotated area.
  6. Click Comment or use the keyboard shortcut to post your annotation and feedback.

Respond to a comment

Comments are hidden by default so that you can focus on the content of a notebook. Items that have comments are indicated by avatars in the right margin. A horizontal row of avatars means that there are multiple comments on that item, and a vertical stack of avatars indicates that more than one of the design items has comments.

  1. To view and respond to comments posted on any notebook content, click the user avatar to open the right side bar.
  2. Begin typing in the comment box to reveal the comment button. You can also hover over a posted comment to react to it with an emoji.
  3. Click Comment or use the keyboard shortcut to post your reply.

Edit or delete a comment or annotation

Users with contributor or viewer seats can edit or delete their own comments with annotations. Admins can delete anyone’s comments. When you delete a comment, this also deletes annotations associated with it.

  1. Click the avatar next to the item where you want to reply to reveal the comment thread and actions.
  2. Hover over your comment..
  3. Click the More Options icon to display the comment options.
    1. To edit the comment, click Edit. Make the desired changes to the text in the comment and click Comment or use the keyboard shortcut to repost the edited comment.
    2. To delete the comment, click Delete…, then click Delete in the confirmation modal to permanently delete the comment.

Resolve a comment or annotation

As discussions around the work evolve, you may have a lot of feedback to go through. You can resolve comments and annotations that have been addressed or are no longer relevant. When you resolve a comment or annotation, it disappears from view so your conversations remain clear and concise. You can still view resolved comments and annotations, and restore them to active if needed.

You cannot resolve comments or annotations made in response to a review.

To resolve a comment or annotation:

  1. In any notebook with comments or annotations you want to resolve, click the user avatar to open the right side bar.
  2. Hover over the comment you want to resolve.
  3. Click the More Options icon to display the comment options.
  4. Click Resolve. The comment disappears from the thread and the number of unresolved comments goes up by one.

View and restore resolved comments

Resolved comments and annotations often have useful information that you want to revisit later, or the topic of discussion may become relevant again in the future. You can choose to temporarily display these resolved comments or annotations and even restore them if you want to reopen the conversation.

To restore a resolved comment or annotation:

  1. In any notebook with comments or annotations you want to restore, click the user avatar to open the right side bar.
  2. To view resolved comments or annotations, click Show resolved comments at the bottom of the comment panel. The resolved comments appear in the thread chronologically among the open comments. Resolved comments are grayed out so you can identify them easily. Additionally, resolved annotations reappear when you click this button.
    Two sample comments in a notebook. Below them, a button appears with the text Show 1 Resolved Comment.
  3. Hover over a resolved comment.
  4. Click the More Options icon to display the comment options.
  5. Click Unresolve. The comment is recolored and the number of unresolved comments goes down by one. If you unresolve an annotation, it appears on the image again.