> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Tags
> Use tags to categorize and quickly find related documents across your spaces.
Think of tags as quick, inline labels you add while writing to make things instantly findable later. They're part of your text – like a lightweight chip – not a separate database you have to maintain.
* **Folders** are where things live.
* **Tags** are how you find and connect things across folders – fast.
Use folders for long-term storage and structure; use tags to slice across topics (ideas, projects, people, stages) without reorganizing your workspace.
## Getting Started
Enable tags in your space settings and start creating them inline as you write.
Navigate to **Space Settings** and select **Tags**.
Enable the Tags feature for your space.
### Creating Tags
Type `#` followed by your tag name. Press Enter to create a new tag, or select an existing one from the suggestions. The text turns into a small badge inline with your writing.
As you type after `#`, Craft suggests existing tags. Choose one to keep names consistent. If nothing matches, press Enter to create a new tag.
Click (or tap-hold) a tag to edit it in place or remove it. Because tags are part of your writing, you change them where they appear.
## Where Tags Work
Tags can be added in multiple contexts across Craft:
* **Documents & blocks**: Tags are inline and can be added anywhere you write – paragraphs, headings, list items, etc.
* **Collections**: Tags typed in text fields look like regular text (not a colored chip), but they behave like tags for finding and filtering. If you want stronger visual emphasis or stricter options, consider single- or multi-select fields.
* **Tasks & Calendar**: Tags also look like plain text here, but still work behind the scenes when those tasks live inside documents.
Inbox is a temporary place. If you tag a task in the Inbox, it won't surface in the Tags view until you move the task into a document.
## Browse with the Tags View
The Tags view lets you see all instances of a tag across your documents.
* **Open it**: Click a tag in your text and choose **Go to tag**, or click a pinned tag in the sidebar.
* **What you'll see**: A list of places where that tag appears; hovering highlights the exact line in context.
* **Refine with filters**: Add more tags to narrow results and discover connections between topics.
* **Pinned tags**: Pin your most important tags to the sidebar for one-click access to a pre-filtered view. This is great for "active project," "ideas," or "journal" style tags.
You can't rename or delete tags from the Tags view. Because tags are part of your writing, edit them in the documents where they live.
## Child Tags
Sometimes you want a tiny bit of structure without creating dozens of separate tags. Use one forward slash (`/`) inside a tag to create a lightweight hierarchy. This helps you organize related tags under a common theme while maintaining flexibility.
### How It Works
Create child tags by adding a slash between the parent and child:
```
#project/design
#project/development
#project/marketing
```
When you click on `#project` in the Tags view, you'll see all documents tagged with any project-related tag. Click on `#project/design` to narrow down to just design-related documents.
### Practical Examples
**Project Management**
Organize work by project phase or discipline:
* `#clientA/research` – User research and discovery for Client A
* `#clientA/design` – Design work and mockups
* `#clientA/development` – Implementation tasks
* `#clientA/review` – Feedback and revisions
**Content Organization**
Group notes by topic and subtopic:
* `#learning/javascript` – JavaScript tutorials and notes
* `#learning/design` – Design principles and inspiration
* `#learning/productivity` – Productivity tips and workflows
**Personal Life**
Categorize personal projects and interests:
* `#home/renovation` – Home improvement ideas and plans
* `#home/maintenance` – Regular maintenance tasks and schedules
* `#travel/europe` – European travel planning and memories
* `#travel/asia` – Asian travel planning and memories
**Reading and Research**
Track sources and topics:
* `#book/fiction` – Notes from fiction books
* `#book/nonfiction` – Notes from nonfiction books
* `#article/tech` – Technology articles
* `#article/business` – Business and strategy articles
### Benefits of Child Tags
* **Flexibility** – Add new child tags without restructuring your entire tagging system
* **Discoverability** – Find all related content by clicking the parent, or narrow down with a child tag
* **Simplicity** – No need to create formal folder hierarchies or complex database structures
* **Personal** – Each team member can organize their own tag hierarchy in shared spaces
### Tips for Using Child Tags
Use only **one level** of hierarchy (`parent/child`). Deeper nesting like `#project/design/ui/mobile` becomes hard to remember and defeats the purpose of lightweight tagging. If you need that much structure, consider using folders instead.
**Start broad, then specialize**: Begin with a few parent tags. As your collection grows, add child tags when you notice clear subtopics emerging.
**Mix approaches**: Not every tag needs children. It's fine to have both `#project/design` (with hierarchy) and `#urgent` (standalone) in the same space.
**Pin parents to sidebar**: Pin the parent tag (`#project`) to your sidebar for quick access. Child tags appear when you click through to the Tags view.
## Settings & Control
Customize how tags work in your space:
* **Enable/disable per space**: In **Space Settings → Tags**, you can turn tags on or off for yourself in that space. In shared spaces, tags are off by default for members; each person can enable them individually.
* **Ignore list**: Prevent unwanted patterns from becoming tags (e.g., numbers, hex codes, or specific words). Use the predefined rules or add your own custom ones.
* **Visual notes**: In documents, tags appear as inline badges; in Collections, Tasks, and Calendar they look like regular text but still function as tags.
## Notes & Limitations
* **Edit in the document**: You can't rename or delete tags from the Tags view; change them where they're written.
* **Shared spaces**: Other members can see tags used in the space. Pinned tags are personal; customize your sidebar as you like.
* **Sidebar organization**: You can show/hide Tags or Folders, reorder them, and use the Starred section (expandable, with quick "+") for favorites.