Skip to content

Tags

Tags are a layer of classification that tessoa keeps for you. Put a colored tag on a file or folder, then click that tag in the sidebar, and everything carrying it comes together in one list — without actually moving anything into some "important" folder.

Tags never change the files themselves. Files under one tag can sit on different drives, in different folders. Rename or move a file inside tessoa and its tags come along.

What tags can do

  • Put one or more tags on a file, or on a whole batch at once.
  • Show colored dots next to filenames in every view (up to 3).
Colored tag dots at the end of list rows, at most three per rowColored tag dots at the end of list rows, at most three per row
Row dots: three, one, two, and none. A row shows at most 3, newest first.
  • Create, rename, recolor, nest, and delete tags in the sidebar.
  • Click a tag in the sidebar to see every file that has it.
  • Find files by tag name with the sidebar quick search (Alt+F).

A fresh install already has seven tags named after their colors: Red, Orange, Yellow, Green, Blue, Purple, and Gray. They are just empty tags with a color picked; rename them to whatever you actually use.

Tagging files

  1. Select one or several files. To pick several, check them with Space.
  2. Right-click → Tags → click the one you want.
  3. With several files selected: as long as one of them does not have the tag yet, they all get it; only once they all have it does clicking clear it.
  4. The menu stays open, so you can click a few tags in a row. Click elsewhere to close it.
Right-click → Tags → Important: the red dot appears and the sidebar count bumps.

Right-clicking empty space gives you Tags for This Folder instead, which tags the folder you are standing in rather than anything inside it. All three platforms work this way.

Dragging files onto a sidebar tag

There is also a direct way: pick up files inside the window and drop them on a tag in the sidebar to give them that tag, several at a time if you like. The files themselves are not moved or copied.

Managing tags in the sidebar

The Tags section in the sidebar is where you keep them in order. The number at the right of each row is how many files carry that tag.

To do thisDo that
Create a tagHover the section header and click
Create a child tagThe at the end of a row → New Child Tag
RenameDouble-click the name, or Rename
Change colorClick the colored dot in front of the name, or Change Color…
Reorder or nestDrag a row: onto the middle of another row makes it a child, between two rows just reorders
DeleteDelete Tag. Child tags survive; they move up a level

After deleting, an undo prompt appears in the footer, so a mis-click is fixable right away.

tessoa sidebar Tags section: colored tags with a nested child, the row-end more menu visible on hovertessoa sidebar Tags section: colored tags with a nested child, the row-end more menu visible on hover
Children indent under "Projects". The number on a row is its file count; hovering reveals the ⋯ menu button.
Drag "In progress" onto the center of "Projects" and it indents into a child tag.

Seeing everything under a tag

Click a tag in the sidebar and a tab opens listing every file carrying that tag (and any tags nested under it), no matter which folder they are actually in.

  • These are still your real files: preview them, open them, right-click them, all as usual.
  • Renaming the tag later changes nothing; the list keeps working.

The sidebar quick search (Alt+F) looks for two things at once:

  1. File names.
  2. Tag names: match one and it lists every file under that tag.

A single Chinese, Japanese, or Korean character is enough to search on; Latin-script queries generally need two letters or more. When a result came from a tag, its tooltip says Matched tag and names it, so you can tell how it was found.

A few things to know

  • At most 3 dots are shown per row, so extras are not visible (the most recent ones win).
  • Files you send to the Recycle Bin from inside tessoa keep their tags if you undo the delete.
  • On macOS, Import Tags from Finder in the Maintenance group reads Finder's tags in. It goes one way only; tessoa never writes back to Finder.
Warning

If you rename, move, or delete files from another program such as File Explorer or Finder, tessoa's tags can no longer find them, and those files stop showing up in the tag list. Run Clean Up Stale Tag References in Settings to tidy up.

User docs for tessoa