Tags are keywords or topics that help you quickly find related notes. You can add tags inline in the note body or in the note’s properties.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/obsidianmd/obsidian-help/llms.txt
Use this file to discover all available pages before exploring further.
Adding tags to a note
Inline tags
Type a hash symbol (#) followed by a keyword anywhere in your note:
Tags in properties
Add tags using thetags property in the YAML frontmatter. Tags in properties should always be formatted as a list:
Tag format
Tags can contain the following characters:- Alphabetical letters
- Numbers
- Underscore (
_) - Hyphen (
-) - Forward slash (
/) for nested tags - Unicode characters, including emojis
#1984 is not valid, but #y1984 is.
Tags are case-insensitive — #tag and #TAG are treated as the same tag.
Tags display with the casing they are first created with in the Tags view. For example, creating
#Tag first means both #tag and #TAG will display as #Tag.| Convention | Example |
|---|---|
| camelCase | #camelCase |
| PascalCase | #PascalCase |
| snake_case | #snake_case |
| kebab-case | #kebab-case |
Nested tags
Use forward slashes (/) to create a tag hierarchy:
- In Search,
tag:inboxmatches#inboxas well as all nested tags such as#inbox/to-read. - In the Tags view, nested tags are shown under their parent tag.
- In Bases, the
hasTagfunction treats nested tags as belonging to the parent:file.hasTag("a")matches both#aand#a/b.
Finding notes by tag
Using search
Use thetag: search operator in the Search panel: