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; clear mentions of your tags are underlined automatically and marked auto. 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.

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 the words, or the dot, and the side panel opens on their thread.

Every comment in one place

Comments in the document's header opens the side panel on its comments: every thread in the document as a card, in the order they come in the text, with the words it is on and who said what. All, Open and Resolved filter them. A card's quote takes you to its words, opening the page they are on; you can reply on the card, Resolve it (it says who resolved it and when, and Reopen brings it back), or delete the thread, with an Undo in the toast. A resolved thread's words read as plain text again; picking its card still lights them. Esc puts you back in the text.

Comments thread, resolve, and support @ mentions that notify the person you name. See Comments for the full model, which is shared with the canvas.

Because a text comment is part of the document, it follows edit access. A viewer sees the dots and reads every thread in the side panel; adding, replying to, resolving or deleting a comment needs edit access.

Tags on a range

A tag can apply to a passage rather than the whole document: select the words, right-click and choose Tag selection…. 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 page lists this passage among everything else carrying it.

Words that clearly refer to one of your tags are underlined on their own, marked auto, in prose and in screenplay blocks alike. Right-click one to remove it, which keeps that tag off the page. A tag you put on a word follows the word as you edit around it, and stays on the page if the word goes.

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 suggested name is a suggestion; it does not become a tag behind you.

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

Names are found without AI. With the workspace's AI suggestions on, the AI also guesses what kind of name each one is; with them off (Settings → Workspace), that guess is left out and no text is sent.

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.

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 under the page tree. They survive edits around them, so a bookmark on "the end of act two" stays there as the act changes length.

Frequently asked questions

What happens to a comment if I edit the text it is attached to?

It follows the text. Comments anchor to the range, not to a character offset, so editing around them keeps them attached to the right passage.

What are the dots in the margins?

Right margin is comments. Left margin is tags and suggested entities. Click one to open it.

Can I turn off the AI in documents?

Yes. The owner or a co-owner can turn AI suggestions off in Settings → Workspace. The automatic underlines stop and no text goes to a model. Suggested names still appear, without the AI's guess at what kind of name each is, and nothing becomes a tag until you accept it.

Machine-readable: /docs/documents/comments-and-tags.md · /llms.txt
What changed and when: /changelog