Tags

Tags label notes so you can find and group them. You add tags in the note body as #tag, or in frontmatter as a tags property.

Add tags in the note

Type a hash tag in the editor:

Meeting notes for #product and #q3

You can also set tags in note properties (frontmatter). Both show up in the sidebar and in search.

Hierarchy with /

Use / for nested tags:

#project/glyph
#area/health
#status/waiting

Parent and child stay related in the Tags list. Prefer a short tree over many flat tags.

Sidebar: Tags

Open the Tags section in the sidebar. You see tags with counts. Use Show more / Show less when the list is long.

Click a tag to focus notes that carry it (or to start a search, depending on the UI action for that entry).

People section

The sidebar also has a People section. People mentions can appear as tags when you enable that behavior in settings.

Check Settings → Space for People mentions as tags. With that on, @person style mentions feed the People list and tag search.

Search with tags

In Search / Quick Open, filter by tag:

Combine tags with words:

roadmap #product
tag:design review

See Search and Command Palette for more query forms (title:, quotes, and filters).

Tags in collections

Boards often group by Tags. Table views can show a Tags column. Editing tags in a collection cell updates the note’s frontmatter/tags the same way the properties panel does.

Beautiful Tags

Beautiful Tags is an appearance option. It changes how tags look in the UI. It does not change what a tag means or how search works.

Tips

• Use folders for projects and areas; use tags for topics that cross folders.
• Keep tag names short and stable. Renaming a tag means updating notes that still use the old name.
• Prefer #project/name over dozens of one-off tags.
• If search misses a tag you just added, rebuild the search index (see Search and Command Palette).

Quick reference