Tags & Organization

Tags let you label blocks for quick filtering and cross-page organization. They live on individual blocks, not pages, so you can tag specific ideas, tasks, or notes wherever they appear.

Creating tags

Type # followed by a tag name anywhere in a block’s text. An autocomplete menu appears showing existing tags that match your query.

Press Enter or click to select a tag. The #tag text is removed from your content and the tag appears as a colored badge on the block.

If the tag doesn’t exist yet, the menu shows a “Create” option at the bottom. Select it to create a new tag.

Tag names

Tags are case-insensitive and stored lowercase. Typing #Work creates the same tag as #work.

Whitespace isn’t allowed in tag names. The autocomplete closes if you type a space after #.

Hierarchical tags

Use / to create nested tag hierarchies like #project/alpha or #work/meetings/standup. The tag badge displays each level with a separator.

Hierarchical tags are stored as single tags, not as separate parent-child relationships. #work/meetings is one tag, not two.

Tag display

Tags appear as colored badges next to block content. Each tag gets a deterministic color based on its name, so the same tag always has the same color across your workspace.

If a block has 1-2 tags, they appear inline with the content. 3 or more tags wrap to their own line below the block for readability.

Removing tags

Hover over a tag badge and click the X icon to remove it from the block. You can also type #tag again in the block to toggle the tag off via the autocomplete menu — already-applied tags show a checkmark.

Searching by tags

Tags are indexed as part of block search text. Searching for a tag name surfaces all blocks with that tag.

The search combines tag names with block content, so a block tagged #urgent will appear in results for “urgent” even if the word doesn’t appear in the block text itself.