Comments and annotations

Using Comments and Annotations makes collaborating on designs easier. Comments encourage general discussion about the work. Annotations simplify the feedback process; your team knows exactly what you’re referring to when you leave a Comment. Use Annotations to highlight specific areas to share your feedback.

How to leave comments and annotations

From an artboard preview, you will find History and Details to the left of the artboard and an area for Comments and Annotations on the right of the artboard.

To leave a Comment:

  1. Enter your Comment in the box on the bottom right.
  2. Click the COMMENT button to submit your Comment.

To annotate a design:

  1. Click the Annotation icon in the bottom left corner of the Comment column.
  2. Click or draw a rectangle over the area you’d like to annotate. A number will appear on your rectangle. This number will be attached to the Comment you leave regarding that specific Comment.
  3. Enter your Comment in the textbox of the right panel.
  4. Click the COMMENT button to submit your Comment.

Your Comment will appear with the number that corresponds to your Annotation, providing context to your team.

Reference Comment histories to see the evolution of conversation around design-work as you work through versions. Read through conversations in a single thread to keep work focused and efficient.


Replies to Comments to help keep the conversation organized and easy to follow. Reply from the Project activity feed, Branch activity feed, or from the layer detail.

Use Reply beneath a Comment to start a thread to help provide clarity and context to conversations.

Comment and Annotation History

Feedback evolves alongside design. Comment history allows teams to easily keep track of conversations around designs as teams iterate and collaborate.

Review the history in each layer detail in the left-hand column. Hover over the historical comments to revisit the Commit where the Comment or Annotation was originally made.

How to resolve comments

As discussions around the work evolve, you may have a lot of feedback to go through. By resolving comments that have been addressed or are no longer relevant, your conversations remain clear and concise.

To resolve a comment:

  1. Hover over any comment on an artboard to access the actions menu.
  2. Click the ☑️ check icon to resolve the comment.

View and restore resolved comments

Resolved comments 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 and even restore them if you want to reopen the conversation.

To view resolved comments:

  1. At the bottom of the comment panel, click SHOW RESOLVED COMMENTS
  2. If the resolved comment was originally made on a previous commit, click on the comment to view it in the context of that commit.

To unresolve comments:

  1. Hover over a resolved comment to access the unresolve button.
  2. Click UNRESOLVE.