- Folders are where things live.
- Tags are how you find and connect things across folders – fast.
Getting Started
Enable tags in your space settings and start creating them inline as you write.
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.
#, 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.
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 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
#learning/javascript– JavaScript tutorials and notes#learning/design– Design principles and inspiration#learning/productivity– Productivity tips and workflows
#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
#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.#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.