# Comments

Comments are a great way to deliver feedback without making direct edits. Comments can be created on both the **Canvas** and **Document**.

Note that a user must be logged in to leave a comment.

## Comments on the canvas

### Creating a comment on the canvas

Comments can be created anywhere on the canvas. 

1. Click on the comment button in the canvas tool bar (or press `C`).
2. Click anywhere on the canvas where you want to create a comment.
3. Type a comment and click on the blue create comment button (or press `Cmd/Ctr + Return`).

<Figure src="/assets/video/eb9eb82-creating-canvas-comment.mp4" alt="" width="600px" border video />

Another way to create a comment is to select a canvas element and click on the comment button in the bottom property bar (or press `Cmd/Ctrl + Shift + M`).

### Moving a comment on the canvas

A comment can be moved simply by dragging the comment bubble to a new location.

<Figure src="/assets/video/ec478e9-moving-canvas-comment.mp4" alt="" width="600px" border video />

### Attaching a comment to a canvas element

A comment can be attached to a canvas element (e.g. shapes, diagrams, text) by either:

* Creating a comment on top of a canvas element OR
* Moving an existing comment on top of a canvas element

When a comment is attached to a canvas element, the comment will move with it when the element is moved.

<Figure src="/assets/video/779743f-attaching-canvas-comment.mp4" alt="" width="600px" border video />

## Creating a comment on the document

### Creating a comment on the document

Comments can be created on any text selection on the document.

1. Highlight text using the cursor or keyboard.
2. Click on the comment button in the right margins of the selected text (or press `Cmd/Ctrl + Shift + M`).
3. Type a comment and click on the blue create comment button (or press `Cmd/Ctr + Return`).

<Figure src="/assets/video/bf320c8-creating-document-comment.mp4" alt="" width="700px" border video />

## Managing comments

### Resolving comments

A comment thread can be resolved by clicking on the 3-dot menu and selecting "Resolve Thread" (or pressing `Option/Alt + R`).

### Deleting comments

A comment thread can be deleted by clicking on the 3-dot menu and selecting "Delete Thread" (or pressing `Option/Alt + D`).

### Hiding comments

If you'd like to toggle the visibility of all comments (show comments / hide comments), you can click on the "Toggle comments" button in the header (or press `Ctrl/Alt + C`).

<Figure src="/assets/video/0728057-toggling-comments.mp4" alt="" width="600px" border video />

## Mentioning collaborators

You can mention collaborators in comments. You can read more about [mentioning here](/mentions).