Skip to main content
Tags group documents across folders. You add them on a document, and you curate the set your workspace uses on the Tags page.

Tagging a document

Open a document and click into the Tags card in the details rail. A list opens with every tag in your registry, each marked with its tier: Area, Topic, or Goal. Pick a tag to add it, and pick it again to take it off. To use a tag that isn’t in the registry yet, type it and choose Add tag “your-tag”. It goes on the document straight away and shows up on the Tags page for review.
  • Tag names are lowercase letters, digits, and hyphens. If what you typed has anything else in it, the option is dimmed with Lowercase, digits and hyphens.
  • A document carries at most five tags. Once it has five, the rest of the list is dimmed with Five at most.
  • To remove a tag, use the cross on it, or press Backspace in the empty field: the first press highlights the last tag and the second removes it.
A document’s tags are shown in a fixed order: its Area, then Topics, then Goals, then any tags not yet in the registry.

The Tags page

Click Tags in the sidebar to open the registry. When documents carry tags that aren’t registered, the sidebar row shows how many are waiting. The Filter by name field at the top narrows every section at once.

The three tiers

Registered tags are grouped into three tiers. They are independent, not a hierarchy: a Topic does not belong to an Area, and a Goal does not belong to either. The page states the convention: every document carries one Area, up to two Topics, and up to two Goals. Its example is a pricing-page spec tagged product, pricing, and acquisition.
Those per-tier counts are guidance, not rules. Nothing checks them. A document with three Areas and no Goal saves without complaint. The only enforced limit is five tags per document.

Creating a tag

Choose New tag. A short form opens: the name, a tier (Area, Topic, or Goal), and an optional description. Choose Save. Tag names are lowercase words joined by single hyphens, such as pricing, customer-success, or q3-launch, up to 64 characters. If you type a name that breaks the rule, the form suggests a corrected one. Press Enter or click it to take it.

The registry

Each tier lists its tags in a table with Tag, Description, and Docs, a live count of the documents carrying that tag. Click a description to edit it in place, or Add description… where there is none. Enter or clicking away saves, and Escape puts back what was there. The ⋯ button on each row opens:
  • Rename: opens a window for the new name. Every document carrying the tag is retagged with the new name, and the registry entry moves with it.
  • Edit description: the same in-place edit.
  • Change tier: move the tag to Area, Topic, or Goal. Its current tier is marked Current.
  • Delete: removes the registry entry after you confirm with Delete tag.
Deleting a registry entry does not untag anything. Documents keep the tag; it just drops out of the tiers. Because those documents still carry it, the tag comes back under Needs review.

Needs review

The Needs review card at the top of the page collects every tag that is on a document but not in the registry. This is how typos and one-off tags surface, including the ones agents coin. Each row shows the tag, how many documents carry it, and two choices. When nothing is waiting, the card reads All tags reviewed.

Add to registry

Choose As area, As topic, or As goal. The tag joins that tier and leaves the queue. The documents themselves don’t change, since they already carry it.

Merge into

Choose Merge into… and pick any registered tag. After you confirm with Merge, documents carrying the loose tag are retagged with the one you picked. If nothing is registered yet, the list shows No registered tags yet.
Merge and delete do different things. Merge retags your documents: after merging pricing-page into pricing, those documents carry pricing. Delete only removes a registry entry and doesn’t touch documents at all.