# 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. A comments toggle hides all of them when you want to see the board clean.

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

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 comments 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

Anyone who can open the board, including viewers. Editing a card is a
different right from talking about it, and feedback is the point of sharing
a board with someone. Public links are the exception: they are anonymous, and
comments need an account.

## 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.