Tag Cleaner: Audit & Merge Messy Tags

Drop your notes folder into this tool and it builds a frequency table of every tag in the vault, plus four kinds of issues: case collisions, singular/plural splits, typos, and nesting mismatches, each with a suggested merge target. Review the list, check the merges you want, and copy a rename map or Obsidian-ready instructions to apply them.

Obsidian's own search treats tags as case-insensitive, but the Tags pane still displays whichever casing was typed first, so a vault can end up with both Project and project live at once, which confuses plugins, Dataview queries, and exports that do compare tags case-sensitively. This tool groups every casing of the same tag together, shows the usage count for each, and suggests the higher-count form as the merge target.

Obsidian's core Search plugin can find every note containing a tag but cannot replace it in bulk. This tool cannot rewrite your files either, it only reads them, but it generates a copyable rename map and, for a one-click fix, points you to the free Tag Wrangler community plugin, which adds a rename option to the Tags pane.

It compares every pair of tags using Levenshtein edit distance, the number of single-character insertions, deletions, or substitutions needed to turn one tag into the other. A distance of 1 or 2 counts as a likely typo, but only when at least one of the two tags is actually used 2 or more times, so a pair of rare, one-off tags that merely look similar is not flagged.

Two lowercased tags where one is the other plus an s, like book and books, or where one ends in y and the other swaps that y for ies, like policy and policies. Only these two common English patterns are checked; unrelated words are left alone.

It is the same tag name used both as a top-level tag and as a nested one, or nested under two different parents, for example todo next to work/todo, or work/todo next to personal/todo. Obsidian treats these as entirely different tags, so notes tagged one way never turn up when you browse the other.

No. It only reads your notes to build the frequency table and issue list. You choose which merges to accept, then apply the rename yourself, either by hand, with the copyable search instructions, or with the Tag Wrangler plugin.