Tags

While folders give your vault a physical structure, tags provide a flexible, cross-cutting way to categorize pages. A page in the work/ folder can be tagged urgent, client-a, and invoicing — letting you slice your vault in ways that folders alone can’t support.

Adding Tags

Tags are managed through the Inspector panel on the right side of the editor.

1. Open the Inspector with Cmd+I / Ctrl+I (or click the Inspector toggle in the toolbar).
2. Find the Tags section.
3. Type a tag name and press Enter to add it.
4. Repeat to add multiple tags.

To remove a tag, click the x button next to it in the Inspector.

Tip

Tags are simple text strings — no special characters required. Use lowercase and hyphens for consistency (e.g., project-alpha, tax-2025, api-keys).

Tag Format

Tags are stored as a YAML array in each page’s frontmatter:

---
id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
title: Project Alpha Notes
folder: work
tags:
  - project-alpha
  - meeting-notes
  - q1-2025
---

Since tags live in standard YAML, they’re portable — you can read or edit them with any text editor or script.

Naming Conventions

Convention	Example	Notes
Kebab-case (recommended)	project-alpha	Lowercase, hyphens between words
Lowercase single word	urgent	Simple, no separators needed
Namespaced	client:acme	Use a colon to group related tags

Avoid mixed casing — ProjectAlpha, project-alpha, and Project Alpha are three different tags. Pick one convention and stick with it.

Filtering by Tag

Click any tag in the Inspector panel (or in the sidebar tag list) to filter the page list to only pages with that tag. This works across all folders — a tag filter shows matching pages regardless of which folder they’re in.

To clear the tag filter, click the active tag again or click the clear filter button in the sidebar.

You can also use the tag filter dropdown in the sidebar header to browse all tags and select one to filter by.

Multiple Tags

When you filter by a tag, the page list narrows to show only matching pages. You can see at a glance how many pages share a given tag.

Tags in Search

Tags are indexed by the search engine with a 2x boost over regular content. This means searching for a tag name surfaces tagged pages prominently:

Field	Search Boost
Title	3x
Tags	2x
Secret labels	2x
Content	1x

When you search for project-alpha, pages tagged with project-alpha rank higher than pages that merely mention the phrase in their body text.

Note

Search looks at tag values as text. You don’t need any special syntax — just type the tag name in the search bar and tagged pages will surface near the top.

Viewing All Tags

To see every tag used across your vault:

1. Open Settings (gear icon or Cmd+, / Ctrl+,).
2. Navigate to Utilities > Tag Management.

This view shows all tags in your vault with the number of pages each tag is applied to, making it easy to spot unused or duplicate tags.

Bulk Tag Operations

The Tag Management utility in Settings lets you perform operations across multiple pages at once:

Action	Description
View all tags	See every tag used in your vault with page counts
Rename a tag	Change a tag name across all pages that use it
Delete a tag	Remove a tag from all pages in one action

Renaming Tags

Select a tag in the Tag Management view and click Rename. Enter the new name and Claspt updates the frontmatter of every page that uses the tag.

Deleting Tags

Select a tag and click Delete to remove it from all pages. The pages themselves are untouched — only the tag is stripped from their frontmatter.

Caution

Renaming or deleting a tag modifies the frontmatter of every affected page. These changes are auto-committed to Git, so you can revert if needed.

Use Cases

Here are some tagging patterns that work well in practice:

Project Tags

Tag pages by project to group related notes across folders:

• project-alpha, project-beta, website-redesign
• Filter by project tag to see all related pages — meeting notes, credentials, specs — in one list

Priority Tags

Surface what needs attention:

• urgent, high-priority, someday
• Pin urgent pages and tag them so they’re findable both ways

Status Tags

Track page lifecycle:

• active, draft, review, done
• Use the Tag Manager to clean up done tags periodically

Category Tags

Create cross-cutting categories that don’t map to folders:

• credentials, meeting-notes, recipes, reference
• Useful when a page could logically belong to multiple folders

Time-Based Tags

Organize by time period for reviews and audits:

• q1-2025, tax-2025, sprint-12
• Makes it easy to find everything related to a specific period

Best Practices

• Use folders for hierarchy, tags for everything else. Folders handle physical structure (work/, personal/). Tags handle cross-cutting concerns (urgent, client-a, q1-2025).
• Keep tags consistent. Decide on a convention early — lowercase with hyphens mirrors the markdown/YAML ecosystem naturally.
• Tag generously. Tags are cheap and searchable with a 2x boost. More tags means more ways to find a page.
• Clean up with the Tag Manager. If tags drift over time, use the bulk rename utility to consolidate. Rename proj-alpha to project-alpha across all pages in one step.
• Don’t over-tag. Three to five tags per page is usually plenty. If every page has fifteen tags, filtering becomes less useful.