Skip to content
Folder Tag Sync Folder Tag Sync Folder Tag Sync

Your first rule

This walkthrough creates a simple folder-to-tag rule: any file under Projects/ gets a corresponding #projects/... tag.

Open settings

Section titled “Open settings”

Settings → Community plugins → click the gear icon next to Folder Tag Sync.

Add a rule

Section titled “Add a rule”

Click Add new rule. The rule editor modal opens.

Direction

Section titled “Direction”

Choose Folder → tag. The UI will show only the fields relevant to this direction.

Folder pattern

Section titled “Folder pattern”

Regex that matches the folder path you want to watch.

^projects/(.*)$

This matches any file directly or recursively under Projects/ (case-insensitive by default — see tag depth nuance for how depth is handled).

Tag entry point

Section titled “Tag entry point”

The prefix applied to the generated tag:

projects/

Transformations

Section titled “Transformations”

Optional pipeline applied to the captured folder segments before tagging. For a clean default:

  • Strip emoji — removes leading emoji from folder names
  • snake_case — converts "My Cool Thing" to "my_cool_thing"

Save and test

Section titled “Save and test”
  1. Click Save
  2. Drop a note into Projects/My First Project/
  3. Run command Folder Tag Sync: Sync folder to tags (current file)
  4. Check the frontmatter — you should see tags: [projects/my_first_project]

Next steps

Section titled “Next steps”