Tags - Obsidian Help
Tags
aliases:
- How to/Working with tags
permalink: tags
Tags are keywords or topics that help you quickly find the notes you want.
Add a tag to a note
To create a tag, enter a hash symbol (#) in the editor, followed by a keyword. For example, #meeting.
You can also add tags using the tags property. Tags in YAML should always be formatted as a list:
---
tags:
- recipe
- cooking
---
Find notes using tags
To find notes using the Search plugin, use the tag search operator in your search term, for example tag:#meeting.
You can also search for tags by clicking on them in your notes.
To find notes using the Tags view plugin, select Tags: Show tags in the Command palette, and then select the tag you want to search for.
Nested tags
Nested tags define tag hierarchies that make it easier to find and filter related tags.
Create nested tags by using forward slashes (/) in the tag name, for example #inbox/to-read and #inbox/processing.
- In Search,
tag:inboxwill match#inboxas well as all nested tags such as#inbox/to-read. - In the Tags view, nested tags are shown as belonging to their parent tag.
- In Bases, nested tags are recognized by the
hasTagfunction, sofile.hasTag("a")will match both#aand#a/b.
Tag format
You can use any of the following characters in your tags:
- Alphabetical letters
- Numbers
- Underscore (
_) - Hyphen (
-) - Forward slash (
/) for Nested tags - Commonly accepted Unicode characters, including emojis and other symbols
Tags must contain at least one non-numerical character. For example, #1984 isn't a valid tag, but #y1984 is.
Tags are case-insensitive. For example, #tag and #TAG will be treated as identical.
Note
Tags will display with the casing they are first created with in the Tags view.
For example, creating #Tag and then #TAG will display #Tag for both.
Tags can't contain blank spaces. To separate two or more words, you can instead use the following formats:
Links to this page
Functions
Obsidian CLI
Properties
Views
Tags
Not found
This page does not exist
Interactive graph
On this page
Add a tag to a note
Find notes using tags
Nested tags
Tag format