Jorrit van der Heide487 downloadsBrowse your vault as a folder tree built from your tags.
Browse your vault as a folder tree built from your tags.
Works well with Loose Ends, which keeps track of the notes you haven't tagged yet, and Paper Trail, which tags your papers by reading status. See Works well with.

Folders make you choose. A summary of a book about coding goes in Books, or
in Coding, but not in both, and half the time you look in the wrong one. Tags
don't have that problem: a note can have as many as it needs. But Obsidian's
tag pane is a flat list, and it doesn't show you the notes.
Did you know Obsidian lets you
nest tags with a slash? #source/book
is a book tag inside a source tag, and #source/article sits right next to
it. Tag Along turns those nested tags into the folder tree you'd want. Every
top-level tag, like source, domain or status, becomes a tree of its own,
and a note shows up under every tag it has. So the book summary sits in
source/book and in domain/coding, and you find it wherever you look.
In Obsidian, go to Settings → Community plugins → Browse, search for "Tag Along", and install and enable it. You can also find it on its page in the plugin directory.
Tag Along needs Obsidian 1.13.1 or later, and works on desktop and mobile.
The first time it loads, Tag Along adds its pane to the left sidebar. If you close it, open it again with the ribbon icon or Tag Along: Open.
Your tags are the folders. Say you have three notes:
Meeting notes : #domain/work #status/active
Research doc : #domain/coding #source/book #status/active
Book summary : #source/book #status/done
Tag Along shows them like this:
domain/
coding/ → Research doc
work/ → Meeting notes
source/
book/ → Book summary, Research doc
status/
active/ → Meeting notes, Research doc
done/ → Book summary
A note tagged both #domain and #domain/coding only shows up in
domain/coding, the deepest of the two.
Now open source/book. Below its notes, the grey domain and status folders
are filter folders. Open status, and you see which of your book notes are
active and which are done.
Here's the same idea in a bigger vault: the Privacy folder, narrowed down by
the Source filter folder to the notes that came from an article.

The buttons at the top of the pane change the sort order, switch compact folders and filter folders on or off, and expand or collapse all folders.
The folders in Tag Along are your tags, so arranging them never moves a file. Hiding, flattening, pinning, moving or reordering a folder only changes Tag Along's own settings. Your notes only change when you rename, copy, move or delete one from Tag Along, and those go through Obsidian the same way they do in the core file explorer. Section 11 lists exactly what it changes and when.
It doesn't connect to the internet and doesn't run any programs.
It's built for big vaults. A test vault of 20,000 notes, each with three to six tags, turns into a tree in about 0.16 seconds on a laptop, and only the folders you open are worked out.
Every change is tested. Every release is built in public on GitHub, and you can check that the file you installed is the one GitHub built. Section 11.4 shows how.
If you want to work on the plugin:
domain, source and status each get a
tree of their own, with their nested tags as folders.project/website.title property or first heading instead of
its file name.status or priority out of the
top of the tree, and only use them as filters.inbox or archive folder show up there
and nowhere else, until you remove the tag.#source/book #status/active.Every tag becomes a folder, and every / in a tag becomes a level. The part
before the first /, like domain in domain/coding, is the top-level tag,
and each top-level tag is a tree at the top of the pane.
A note tagged #domain and #domain/coding is listed in domain/coding only.
Tag Along only lists a note in the deepest folders its tags reach, because
otherwise every note would show up again in every parent folder. A note with
tags under three top-level tags shows up in three trees.
Upper and lower case don't matter, so #Book and #book end up in the same
folder. The folder is named the way the tag is spelled in the first note that
has it.
Filter folders let you combine top-level tags. Open domain/coding, then the
grey source folder inside it, then book, and you see the notes on coding
that came from a book.
Below the notes in a folder, you'll find your other top-level tags in grey,
apart from the ones you used to get there. They only sort through the notes
listed directly in the folder, because its sub-folders already split up the
rest. You can open one filter folder inside another, like source and then
status. Tag Along only offers one when it narrows something down. At least two
of the notes need a tag under it, and they can't all have the same one.
Most of the time each setting does one simple thing. Here's what happens when a few of them meet on the same tag:
project/reading to the top level and then hide project.
reading stays visible, because it doesn't live in project anymore.reading tag, the moved project/reading joins it,
and you get one reading folder for both.inbox exclusive, and a note tagged #inbox and #domain/work only
shows up in inbox. Once you take #inbox off, it's back in domain/work.status filter-only, and a note tagged only #status/active has no
folder to be in. It counts as untagged.When the Tag Along pane has focus:
| Key | Action |
|---|---|
| ↑ / ↓ | Move up or down one row |
| → | Open a folder, or go into an open one |
| ← | Close a folder, or go to its parent |
| Enter | Open the note, or open or close the folder |
| Ctrl/Cmd+Enter | Open the note in a new tab |
| F2 | Rename the note |
| Delete or Backspace | Delete the note, or all selected notes |
| Escape | Clear the selection |
| Mouse | Action |
|---|---|
| Click | Open a note, or open or close a folder |
| Ctrl/Cmd+click | Open the note in a new tab |
| Alt+click | Add a note to the selection, or take it out |
| Shift+click | Select every note between the last one and this one |
| Right-click | The note or folder menu, or the menu for the selection |
| Drag a folder | Put it in your own order, or drop it below all others to pin it |
| Drag a note | Drop it in a note to link to it, like from the file explorer. Drags all selected notes when it's one of them |
| Ctrl/Cmd+hover | Preview the note |
Deleting works the way it does in the file explorer, so Obsidian asks you first if your settings say it should.
None of the commands come with a hotkey, so they won't clash with the ones you already use. You can set your own in Settings → Hotkeys.
Tag Along: Open - Shows the tree in the left sidebar. Also available from
the ribbon.Tag Along: Reveal current note - Opens the folders down to the note you have
open, and highlights it. Also in the file menu as Reveal in Tag Along.Tag Along: Expand all folders - Opens every folder in the tree.Tag Along: Collapse all folders - Closes every folder in the tree.Tag Along: Toggle compact folders - The same as the button at the top of the
pane.Tag Along: Toggle filter folders - The same as the button at the top of the
pane.Most folder settings can also be changed by right-clicking a folder. The lists in the settings are where you undo them.
Folders
| Setting | Default | |
|---|---|---|
| Compact folders | On | Show a folder and its only sub-folder as one entry. |
| Filter folders | On | Show your other top-level tags as grey folders, to narrow a folder's notes down. |
| Folder order | None | Folders you dragged into place come first, and folders you pinned to the bottom come last. All the others follow the sort order, in between. Remove one to put it back in sort order. |
| Top-level folders | None | Sub-tags that get a folder of their own at the top of the tree. One with the same name as a top-level folder joins it. They aren't offered as filter folders. |
| Flat folders | None | Folders that list every note below them, from their sub-tags too, instead of showing sub-folders. |
| Exclusive folders | None | Notes with these tags, or their sub-tags, only show up in these folders. Their other tags are ignored, in the tree and in filter folders. |
| Filter-only folders | None | Top-level tags you only filter by, like status. They only show up as grey filter folders inside other folders, and not at all with filter folders off. A note with no other tags counts as untagged. |
| Hidden folders | None | Tags and their sub-tags that get no folder, and no filter folder either. Their notes still show up under their other tags, and a note with no other tags counts as untagged. A sub-tag you moved to the top level stays visible. |
| Show untagged notes | Off | List notes without tags at the top of the tree. |
Notes
| Setting | Default | |
|---|---|---|
| Show note titles | On | Show the title property or first heading instead of the file name. |
| Show note counts | Off | Show how many notes each folder holds. |
| Open tags in Tag Along | Off | Clicking a tag in a note opens its folder instead of searching for it. Ctrl/Cmd-click still searches. |
Which notes to show
| Setting | Default | |
|---|---|---|
| Included folders | Whole vault | Only notes in these folders show up. Leave it empty for the whole vault. |
| Excluded folders | None | Notes in these folders are left out, even inside an included folder. |
| Excluded tags | None | Notes with these tags, or their sub-tags, are left out of the tree. |
I made these too. Each one does one thing and works on its own, but they fit together nicely.
Loose Ends lets you write a
note now and tag it later. You tell it which kinds of tag every note needs, like
a domain/… tag and a source/… tag, and until a note has them all, it gets
one extra tag saying it isn't filed yet.
In Tag Along, domain and source are each a tree, and the extra tag is a folder
of everything still waiting. Set Loose Ends' unfiled tag to inbox, and make
inbox an exclusive folder in Tag Along. A new note then only shows up in
inbox, and moves to its proper folders the moment you've finished tagging it.

Paper Trail turns your
Zotero library into a reading queue. Set its Status tag to status, and
your papers show up in Tag Along under status/queued, status/summarised and
so on. Open one, and the filter folders let you narrow it down by topic.
Tag Along runs entirely on your device. It never connects to the internet and doesn't send anything anywhere.
title property and first heading of the Markdown notes
in your vault, which it gets from Obsidian's own index of your notes.Only when you ask for it, and only these:
title property, if they showed the old name, and renames the file, if it was
named after the old name. A file name that isn't the title, like an ID or a
citation key, stays as it is.Nothing else Tag Along does changes a note. Everything you do to folders, like hiding or pinning one, only changes Tag Along's own settings.
data.json in the plugin folder.Every change I push is built, checked with ESLint and the official Obsidian ESLint plugin, and tested with Vitest. Nix builds it a second time, on its own.
Releases are built by GitHub Actions from the tagged code, after the same
checks. A release only goes out when its tag matches the version in
manifest.json, and every action it uses is pinned to an exact version. Each
release comes with a signed attestation from GitHub, which records what it
was built from. To check that the main.js you installed is the one GitHub
built:
gh attestation verify main.js --repo jorritvanderheide/obsidian-tag-along
Have a look at the FAQ first. It covers the things people run into most, like a note that doesn't show up where you expect. If something still doesn't work, or you have an idea, please open an issue. Found a security problem? Please report it privately, the way the security policy explains.
The code lives on Codeberg, with a copy on GitHub.
Tag Along is free. If it's useful to you and you'd like to give something back, you can do that on Liberapay:
Copyright © 2026 Jorrit van der Heide. Licensed under the EUPL-1.2.
Tag Along started as a fork of TagFolder by vorotamoroz. Version 2 is a complete rewrite and shares no code with it, and the releases up to 1.1.1 are still available under the MIT license.