Skip to content

Organize Tags

dhwang0803-glitch edited this page Jul 24, 2026 · 1 revision

Organize Tags

Find and merge duplicate tags across your vault using AI-powered similarity detection. Covers both simple typos (casing, hyphens, pluralization) and semantic duplicates across languages.


How to Use

Open the Command Palette (Ctrl/Cmd + P) → Organize Tags


How It Works

Tag scanning runs in two stages:

Stage 1 — String Normalization

Groups tags that differ only in surface form:

  • Casing: #project-management vs #ProjectManagement
  • Hyphens/underscores: #to-do vs #todo
  • Pluralization: #recipe vs #recipes

This stage is fast and doesn't require AI.

Stage 2 — AI Embedding Similarity

Detects semantically similar tags that string matching can't catch:

  • Cross-language: #meeting-notes vs #회의록
  • Synonyms: #coding vs #programming
  • Related concepts: #machine-learning vs #ML

This stage uses your AI provider's embedding model and processes tags in batches (up to 200 tags per batch).


The Result Panel

Each duplicate group shows:

Element Description
Canonical tag The recommended tag to keep (editable)
Variant list All similar tags that will be merged
Affected notes Number of notes that will be updated
Badge Group type — Nest (hierarchical) or Related (info only)

Actions

Button What it does
Merge Replace all variants with the canonical tag in every affected note
Nest Create a nested tag hierarchy instead of flat merge
Edit Customize the canonical tag name before merging
Skip Skip this group without merging
Undo Revert a completed merge

Batch Operations

  • Select All checkbox at the top
  • Merge / Skip buttons act on all selected groups

Editing a Group

Click Edit to customize a group before merging:

  1. Keep tag (canonical) — select which tag to keep from the dropdown
  2. Custom tag — or enter an entirely new tag name
  3. Variants — review which tags will be merged
  4. Click Save to apply your edits

What Merge Does

When you merge a tag group:

  1. Every affected note's frontmatter is updated
  2. All variant tags are replaced with the canonical tag
  3. The change is recorded in the Activity Log with full undo support

Re-scan

Click Re-scan to run the analysis again. This is useful after merging some groups — the remaining tags may form new groups.


Related

Clone this wiki locally