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 design content added from plugins

You can also leave feedback about 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 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 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 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

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.