# Comments, tags and backlinks in documents

> Select text in a document and comment on it — the comment attaches to that range and shows as a dot in the right margin. Tags applied to a range underline the text and show in the left margin. The app also suggests entity names it notices, which you confirm or dismiss with a tick or a cross, and backlinks show everywhere the document is referenced from.

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

Documents carry annotation in the margins, so the text stays clean and the
apparatus stays visible.

## Comments on a range

Select text and add a comment. It anchors to that **range**, not to a character
position, so editing around it keeps it attached to the right passage.

Commented text is marked inline, with a gold dot in the **right margin**. Click
a dot to open the thread.

Comments thread, resolve, and support `@` mentions that notify the person you
name. See [Comments](/docs/collaborate/comments) for the full model, which is
shared with the canvas.

## Tags on a range

A [tag](/docs/organize/tags) can apply to a passage rather than the whole
document. Tagged text is underlined, with dots in the **left margin**.

This is what lets a script's mention of a location connect to the reference wall
for that location — the tag's detail view will list this passage among
everything else carrying it.

## Suggested entities

As you write, names that look like entities — characters, locations,
organizations — are detected and offered in the margin with a tick and a cross.

**Nothing is applied until you accept it.** A suggestion is a suggestion; the
document is not silently tagged behind you.

Accepting one creates or links the entity, so the next occurrence anywhere is
recognised automatically.

The detector is on by default and can be switched off in settings if you would
rather work without it.

## Links and mentions

Type `@` to reference a cluster, document, card, tag or person. Mentions render
as links with hover previews and register as backlinks on the target.

URLs typed or pasted become links automatically.

See [Links and mentions](/docs/organize/links-and-mentions).

## Backlinks

The **Referenced by** panel lists everywhere this document is linked or
mentioned from — other documents, notes, cards, messages.

Backlinks are the reason mentioning things is worth the keystroke: a location's
entity page ends up listing the script scene, the reference board and the
message thread that all pointed at it, without anybody maintaining an index.

## Bookmarks

Not annotation but adjacent: bookmarks are durable anchors into specific places
in a document, listed in the right pane. They survive edits around them, so a
bookmark on "the end of act two" stays there as the act changes length.