How TagSpaces Stores Tags and Keeps Them With Your Files

Updated

TagSpaces stores tags as part of the file system itself—right beside your documents—rather than in a separate database or cloud service. This means tags travel with your files when you copy, move, or sync them across devices and platforms, and you can read them without TagSpaces installed. The trade-off is that tag data lives in file names or sidecar files, so you need to understand the storage format before relying on it for large libraries.

Where the tags actually live

TagSpaces is a local-first file organizer. According to the project's own description, it uses "no database—tags travel with your files across devices and platforms," and "tags, descriptions, and colors are stored right beside your documents." That design is the core of its portability claim: there is no backend, no account, and no vendor lock-in.

In practice, this means tag information is written into the same folder as the file it describes. When you move a tagged file to another drive or sync it to a colleague's machine, the tag metadata goes along with it—provided you move the whole folder structure, not just the file.

What this looks like for a single file

  • Tags: attached to the file itself, so they remain visible in the file system.
  • Descriptions and colors: stored alongside the document, not in a hidden app database.
  • Notes: written as standard Markdown, HTML, or plain text files that you fully control.

Because everything is plain and readable, you can inspect the metadata with any text editor or file manager. That is what makes the format "future-proof" in the project's words: no proprietary binary store stands between you and your data.

Why tags survive device and platform changes

The portability comes from three design choices described on the site:

  1. No login and no backend. TagSpaces runs entirely on your device, with no account and no data collection. There is no server-side tag index that could be lost or locked.
  2. Local-first, offline-first. You can work without an internet connection, and syncing is optional—you choose the tool (Nextcloud, Dropbox, Syncthing, Google Drive) rather than the app forcing one.
  3. Plain, readable files. Tags, descriptions, and colors sit next to your documents, so any sync tool that copies files also copies the tags.

The practical consequence: if you sync a folder with Syncthing or Dropbox, the tags move with the files because they are part of the folder contents. If you switch operating systems—Windows, macOS, or Linux—the same folder opens with the same tags.

What you can tag, and how it is applied

TagSpaces applies color-coded tags to both files and folders. The site describes this as a differentiator: "Unlike most file tagging applications, we do not" rely on a central database. You can also annotate files and folders, and collect web content as plain files (HTML, MHTML/PDF, PNG, URL) through the Web Clipper for Chrome, Edge, and Firefox.

A concrete example: suppose you save a research PDF and a screenshot of the source page into a project folder. You tag both with a color-coded "research" tag and add a short description. Later you copy that folder to an external drive and open it on a Linux machine. The tags and descriptions are still there because they were written beside the files, not registered in an app-specific index.

Conditions and limits to check before committing

  • You must keep the folder structure intact. Tags travel with files, but only if the metadata files travel too. Copying a single file out of its folder may separate it from its tag data.
  • Syncing is your responsibility. The app does not provide a cloud; you pick Google Drive, Dropbox, Syncthing, or another tool. Portability depends on that tool copying all files in the folder.
  • Encryption is external. The site suggests Cryptomator for encryption, so tag readability assumes an unencrypted or separately unlocked volume.
  • Pricing and Pro features are separate. The site links to a TagSpaces Pro product page and subscription terms, including a 14-day money-back guarantee and cancellation terms. The free, open-source core is described as available for Windows, macOS, Linux, and the web; check the Pro page for what the subscription adds before assuming any feature is free.

If your priority is tags that remain readable and movable without a vendor, TagSpaces' file-based approach fits. If you need a centralized tag index shared across many users with server-side search, that is a different architecture and you should verify whether the sync setup you choose meets it.