Comment and annotate in a notebook

Comment 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 comment icon on the right side of the page.
    Notebooks_Comment01-hover.png
  2. Click the comment icon to open the right sidebar. The block that you are commenting on will be highlighted.
  3. Type in the comment box to reveal the comment button.
    Notebooks_Comment02-mention.png
  4. Click Comment or use the keyboard shortcut to post the completed comment.
    Notebooks_Comment03-typed.png

Tip: You can submit your comments using a keyboard shortcut: CMD+Enter (Mac) or CTRL+Enter (PC).

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 will keep your discussions and decisions together in one space.

  1. Click on any design item or image to select what you want to comment on.
    Notebooks_Comment-FrameSelect.png
  2. Click the frame again to enter the item detail view. You can post comments on the right side of this screen.
    Notebooks_Comment-FrameView.png
  3. Click Comment or use the keyboard shortcut to post the comment.
    Notebooks_Comment-FrameTyped.png
  4. Click the arrow button 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.
    Notebooks_Comment-FrameAnnotate-tip.png
  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.
    Notebooks_Comment-FrameAnnotate-created.png
  5. Type in the text box to add your comments about the annotated area.
    Notebooks_Comment-FrameAnnotate-commented.png
  6. Click Comment 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.
    Notebooks_Comment-Reply01.png
  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.
    Notebooks_Comment-Reply02.png

Edit or delete a comment

Users with contributor or viewer seats can post comments, and can edit or delete their own comments. Admins can delete anyone’s comments.

  1. Click the avatar next to the item where you want to reply to reveal the comment thread and actions.
    Notebooks_Comment-Reply03.png
  2. Hover over your comment to display the more options menu [three dots icon].
    Notebooks_Comment-Reply04.png
  3. Click the more options menu [three dots icon] to view edit and delete options.
    Notebooks_Comment-Edit.png
  4. 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.
    Notebooks_Comment-EditText.png
  5. To delete the comment, click Delete… then click Delete in the confirmation modal to permanently delete the comment.
    Modal_Delete-Comment.png

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 to display the more options menu [three dots icon].
  3. Click the more options menu [three dots icon] to view comment options.
  4. Click Resolve. The comment disappears from the thread and the number of unresolved comments goes up by one.Notebooks_Comment-ResolveComment.png

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.Notebooks_Comment-SeeResolvedComments.png
  3. Hover over a resolved comment to display the more options menu [three dots icon].
  4. Click the more options menu [three dots icon] to view 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. Notebooks_Comment-UnresolveComment.png

Edit or delete an annotation

Users with contributor or viewer seats can edit or delete their own comments with annotations. Admins can delete anyone’s comments, which will also delete annotations associated with those comments.
  1. Click on any design item to select what you want to comment on.
  2. Click the frame again to enter the item detail view.
  3. Hover over your annotated comment to display the more options menu [three dots icon].
  4. Click the more options menu [three dots icon] to view edit and delete options.
    Notebooks_Comment-FrameAnnotate-edit.png
  5. To edit the annotation or the associated comment, click Edit. Use the handles to move or resize the annotation box to the desired size and location and click Comment to repost the edited annotation.
    Notebooks_Comment-FrameAnnotate-edited.png
  6. To delete the annotation, you must delete the entire comment. In the more options menu, click Delete… then click Delete in the confirmation modal to permanently delete the comment and its annotation.