# Comments

> A comment anchors to whatever it is about — a card, a group, an empty point on the canvas, the board as a whole, or a range of text inside a document. Comments thread, resolve, and support @ mentions that notify the person named. An eye toggle hides all of them when you want to see the board clean.

_Source: https://clusters.soleilpictures.com/docs/collaborate/comments · Updated 2026-08-08_

Comments attach to the thing they are about. This is the whole design: feedback
that lives in a sidebar, ordered by time, loses the connection to what it
referred to within a day.

## What you can comment on

| Anchor | Reads as |
|---|---|
| A **card** | "this image" |
| A **[group](/docs/canvas/groups)** | "this sequence" |
| An **empty point** | "something should go here" |
| The **board** | "the whole thing" |
| A **text range** in a [document](/docs/documents/comments-and-tags) | "this sentence" |

Right-click → **Comment**, or the rail's **+** → *Annotate* → **Comment**.

## Threads

Comments thread with replies. **Resolve** when the thing is dealt with —
resolved comments are archived rather than deleted, so the record of why
something changed survives.

## Mentions

Type `@` in a comment to mention someone. They are notified. See
[Notifications](/docs/collaborate/notifications).

You can also mention clusters, documents and cards, which turns a comment into a
navigable link rather than a description of where to look.

## Hiding them

The eye toggle hides every comment bubble on the board — for you only, not for
everyone. Use it when presenting or when the feedback has piled up and you want
to see the work.

## Bubbles on a crowded board

Comment bubbles lay themselves out to avoid covering the content they refer to
and to avoid stacking on each other, so a heavily-reviewed board stays readable.

## Who can comment

Editors can. **Viewers cannot** — a viewer can read the board and
[vote](/docs/canvas/vote-cards), but leaving comments requires edit access. If
you want feedback from someone, invite them as an editor; it costs nothing on
any plan. See [Collaborating](/docs/collaborate).

## Comments versus votes

- A **comment** is a sentence: reasoning, a request, a decision, with a thread and a record.
- A **[vote](/docs/canvas/vote-cards)** is a count: which of these, quickly, with no discussion.

If you want to know *why*, use a comment.