# Tags

```yaml
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](/content/help/properties/index.html). Tags in YAML should always be formatted as a list:

```yaml
---
tags:
  - recipe
  - cooking
---
```

## Find notes using tags

To find notes using the [Search](/content/help/plugins/search/index.html) plugin, use the `tag` [search operator](/content/help/plugins/search#Search%20operators/index.html) 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](/content/help/plugins/tags/index.html) plugin, select **Tags: Show tags** in the [Command palette](/content/help/plugins/command-palette/index.html), 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](/content/help/plugins/search/index.html), `tag:inbox` will match `#inbox` as well as all nested tags such as `#inbox/to-read`.
- In the [Tags view](/content/help/plugins/tags/index.html), nested tags are shown as belonging to their parent tag.
- In [Bases](/content/help/bases/index.html), nested tags are recognized by the [`hasTag`](/content/help/bases/functions#hasTag/index.html) function, so `file.hasTag("a")` will match both `#a` and `#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](/content/help/tags#Nested%20tags/index.html)
- 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](https://publish.obsidian.md/#y1984) is.

Tags are case-insensitive. For example, [#tag](https://publish.obsidian.md/#tag) and [#TAG](https://publish.obsidian.md/#TAG) will be treated as identical.

**Note**  
Tags will display with the casing they are first created with in the [Tags view](/content/help/plugins/tags/index.html).

For example, creating [#Tag](https://publish.obsidian.md/#Tag) and then [#TAG](https://publish.obsidian.md/#TAG) will display [#Tag](https://publish.obsidian.md/#Tag) for both.

Tags can't contain blank spaces. To separate two or more words, you can instead use the following formats:

- [#camelCase](https://publish.obsidian.md/#camelCase)
- [#PascalCase](https://publish.obsidian.md/#PascalCase)
- [#snake_case](https://publish.obsidian.md/#snake_case)
- [#kebab-case](https://publish.obsidian.md/#kebab-case)

Links to this page

[Functions](/content/help/bases/functions/index.html)  
[Obsidian CLI](/content/help/cli/index.html)  
[Properties](/content/help/properties/index.html)  
[Views](/content/help/bases/views/index.html)

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