Links and mentions
Type @ anywhere you can write to mention a cluster, document, card, tag or person. Mentions become real links with hover previews, and they register as backlinks so the thing you mentioned can show everywhere it is referenced from. URLs and names of things you already created are detected and linked automatically.
Mentions are how separate parts of a workspace find out about each other.
Mentioning
Type @ in a note, a document, a card title or a message, then start typing a name.
You can mention a cluster, document, card, note, image, palette, group, tag, URL or person.
The result is a real link. Hovering shows a preview appropriate to the type — an image shows the image, a board shows its thumbnail, a person shows who they are. Clicking navigates.
Automatic links
Two things happen without you asking.
URLs typed or pasted become links, with previews on hover. Pasted onto an empty canvas, a URL becomes a full link card instead.
Known names are detected. Once a tag or entity exists, later occurrences of its name in your writing are quietly underlined and connected. Writing "Diner" in a note after creating a Diner entity links the two without any @.
Backlinks
The reverse direction, and the reason mentions are worth the keystroke.
Anything that gets mentioned can show a Referenced by panel listing everywhere it was mentioned from — documents, notes, cards, messages, boards.
A location entity ends up listing the script scene, the reference wall, the schedule entry and the message thread that all pointed at it. Nobody built that index; it is a by-product of writing normally.
Deep links
Copy link on any card gives a URL that opens the board with that card selected and in view. Paste it into a message, a document or an email.
Deep links carry the target through sign-in, so a recipient who is not logged in lands in the right place after authenticating rather than at the home screen.
Where mentions work
| Surface | @ mentions | Auto-links | Backlinks |
|---|---|---|---|
| Notes | ✓ | ✓ | ✓ |
| Documents | ✓ | ✓ | ✓ |
| Card titles | ✓ | ✓ | ✓ |
| Messages | ✓ | ✓ | ✓ |
| Comments | ✓ | ✓ | — |
Mentioning a person in a comment or a note notifies them. See Notifications.
The graph
Everything described here feeds the Home graph, which renders these relationships as something you can fly through.
Frequently asked questions
What can I mention?
Clusters, documents, cards, notes, images, palettes, groups, tags, URLs and people. Each gets a preview appropriate to what it is.
What are backlinks?
The reverse direction. If a document mentions a location, that location's panel lists the document. You get an index of what references what without maintaining one.
Can I link to a specific card?
Yes. Copy link on any card gives a URL that opens the board with that card selected.
Machine-readable: /docs/organize/links-and-mentions.md · /llms.txt