Tagging a document
Open a document and click into theTags 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.
The Tags page
ClickTags 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.
Creating a tag
ChooseNew 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 withTag, 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 toArea,Topic, orGoal. Its current tier is markedCurrent.Delete: removes the registry entry after you confirm withDelete tag.
Needs review
TheNeeds 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
ChooseAs 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
ChooseMerge 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.