Tags and entities

A tag cuts across everything — put one on a card, a whole cluster or a passage of a document, and the tag's page gathers all of them from anywhere in the workspace. Tags can be typed as a character, setting, organization, topic or thing. A tag is applied on its own only where its exact name appears; beyond that the AI suggests tags and underlines clear mentions in documents, everything it does is marked auto, and the workspace owner can turn it off.

Updated November 9, 2026

Tags are the cross-cutting layer. Clusters give you hierarchy; tags give you everything that does not fit a hierarchy.

Tagging

• A card — right-click it and choose Tag…. The picker suggests as you type, and Enter creates a tag that does not exist yet.
• Several cards at once — select them and press Tag in the selection bar (or right-click one and choose Tag … cards…). Each tag shows how many of the selected cards carry it (✓ all, – some); clicking puts it on all of them, or takes it off all of them when they all have it. Dropping a tag from the sidebar onto a selected card tags the whole selection.
• A group, as a unit — right-click its label and choose Tag group….
• A whole cluster — right-click an empty part of it and choose Tag this cluster…, or drag a tag from the sidebar onto it.
• A passage of text — in a document, select the words, right-click and choose Tag selection…; a name the app has noticed can also become a tag right where it appears.

An item can carry several tags. A card's show as chips just under it (four, then a +N for the rest). A tag is not a location. Tagging moves nothing.

Lighting a tag up on a cluster

Click a tag chip — on a card, on a group's label, or on the cluster's own strip at the top — and the cluster lights up that tag: its cards stay as they are and everything else recedes. Nothing moves and nothing is hidden. A pill at the top says what is showing and how many cards carry it ("Showing Onyx · 6 of 14 cards"); Esc, the ×, or clicking the same chip again ends it. A card in a tagged group counts.

The tag page

Open a tag from the sidebar, from the tag in the spotlight pill, from a chip's right-click menu (Open tag page), or from its hover card, and you get everything carrying it, from anywhere in the workspace — clusters, then groups, then cards — and the document pages it is on. A tagged group or cluster shows what is inside it. Its header counts both: "12 tagged · 40 inside" is twelve things carrying the tag (the number the sidebar shows) and forty more inside the tagged clusters and groups.

This is the payoff. "Show me everything about the diner" spans a script scene, a reference wall, a group of location photos and a note, and no folder structure could have anticipated that grouping.

Entity types

A tag can be typed:

The type shows on a tag's hover card and its page, the sidebar groups tags by it, and it drives the hover previews and backlinks in links and mentions.

Automatic tagging

Automatic tagging works from text — card titles, notes, documents, and the names of groups and clusters — and only uses tags you have already made, so a workspace with no tags gets none. Pictures are read too, but they only ever get suggestions (see below).

• An exact name match is applied, marked auto. Tag names can be in any script: where the script puts spaces between words a name matches whole words only, in Korean it also matches with a particle after it (서울 in 서울에서), and in Chinese, Japanese and Thai it is found inside running text. Make a Diner tag, and a note that mentions the diner picks it up, as does a group called "Diner stills". Creating a tag applies it straight away to what already says its name.
• In documents, clear mentions are underlined, marked auto: the AI underlines words that clearly refer to one of your tags, even when they are not its exact name.
• Anything looser is only suggested. The AI compares what a card says with your tags, and the closest suggestion shows on the card as a hollow chip with a sparkle: ✓ keeps it, × means never suggest it there. The rest wait on the tag's page, under Manage.
• Pictures are suggested, never tagged. Each picture added to a cluster is described by an AI model. When the description names one of your tags, or means something close to it, the picture gets that tag as a suggestion, a few minutes after it lands, without a reload; hover the chip and it says it came from the picture. A picture is never tagged on its own.

The AI reads up to 2,000,000 characters per account a day, counting the instructions sent along with your text, more than a normal day's work needs. Past that, it pauses until the next day.

The owner or a co-owner can turn AI suggestions off in Settings → Workspace. Then Clusters sends no card or document text and no picture to a model: there are no suggestions or underlines, the workspace's picture descriptions are deleted, and exact-name matches and the tags you add work as before. An AI app you connect yourself, through the API or MCP, still reads what you ask it to.

Nothing applied automatically is hidden. Open the tag, press Manage and filter to Auto to see everything it picked up on its own. Right-click any item (on a phone, press and hold it) for Confirm tag or Remove tag — removing also keeps that tag off that item for good, so it is never applied there again. In a document, removing a tag keeps it off that page.

Removing, deleting and merging — all reversible

Removing a tag from one item shows an undo toast; undoing also lifts the "don't suggest this again" that a removal writes, so the matcher behaves as if the removal never happened.

Deleting a tag removes it everywhere, but softly: the tag and every one of its applications stay recoverable for 30 days — from the undo toast, or by recreating a tag with the same name, which revives the old one intact.

Merging one tag into another can also be undone from its toast: applications move back, and the merged-away tag returns. Anything you had taken the merged tag off stays off under the tag it merged into.

Finding by tag

• The sidebar lists workspace tags, grouped by type; the arrow keys walk them and Enter opens one. A tag's ⋯ (or right-click) renames, recolors, merges, types or deletes it
• ⌘K finds tags by name, and # with a tag's name lists everything carrying it
• The tag page is the full browse

Scripts and AI assistants read and apply tags the same way, through the Tags API and the MCP server.

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