Finder tags not working: what to check, in order

When Finder tags stop working on a Mac, the cause is almost always one of four separate failures that look the same from the outside: the tag was never written to the file, it was written but Finder is not showing it, it is shown but search and the sidebar cannot find it, or it was lost when the file was copied or synced. Each one has a different fix, and the fastest route is to find out which layer failed before changing any settings. The checks below go in that order, from the one that takes ten seconds to the one that takes an afternoon.

The menu names come from Apple's current Mac User Guide page on tags, and the technical details from Apple's documentation and from Howard Oakley's December 2024 analysis on The Eclectic Light Company. The commands were run on macOS on October 8, 2026.

Sort the symptom before touching anything

What happens	Layer that failed	First check
Choosing a tag does nothing, or the dot never appears	Writing the tag	Get Info on the file
The tag is in Get Info but missing from the window, the menu or the shortcuts	Display and settings	Finder > Settings > Tags
Clicking a tag in the sidebar shows an empty window, or searching by tag finds nothing	Spotlight index	Indexing status of the volume
Tags were there yesterday and are gone after a copy, sync or restore	Storage and transfer	Where the file lives and how it got there

The mistake that wastes the most time is rebuilding the Spotlight index for a problem in the first or second row, or relabelling tags for a problem in the third. The table keeps the diagnosis honest.

One fact explains why the layers fail independently. A Finder tag is stored as an extended attribute on the file itself, named com.apple.metadata:_kMDItemUserTags, holding a short list of text labels with a colour number. Finder reads that attribute to draw the dot. Spotlight reads it separately to build its index, and the tag view in the sidebar is a search against that index, not a scan of the disk. So a file can carry a perfectly good tag that Finder displays while the sidebar shows nothing, because the index never caught up.

Step 1: confirm the tag is actually on the file

Select the file and press ⌘I to open Get Info. The Tags field near the top lists every tag on the file. If the tag is there, the writing layer is fine and the problem is further down the table. If it is not there, the tag was never saved.

For a check that does not depend on Finder at all, open Terminal and run:

xattr -l ~/Documents/example.pdf

A tagged file lists com.apple.metadata:_kMDItemUserTags in the output. When Finder writes the tag, the value is a binary property list, so it prints as hex rather than readable text, but the presence of the attribute is the answer that matters. No attribute means no tag, whatever the window shows.

Common reasons a tag is not written:

• The file is locked or read only. Files on a read only volume, inside a disk image mounted read only, or with the Locked checkbox ticked in Get Info may refuse the change, so the tag silently fails to save.
• The file is on a volume that does not support extended attributes properly. The Eclectic Light analysis notes that tags are best supported on APFS and HFS+ and may have limitations on other file systems.

To retag from Finder, select the item and open the File menu or Control click it, then choose a colour above Tags, or click Tags to pick or type one. If the attribute still does not appear after that, run Disk Utility's First Aid on the volume. Oakley's article treats failures at this basic level as a reason to suspect file system errors.

Step 2: the tag exists but Finder is not showing it

If Get Info shows the tag and the window does not, the cause is usually a setting, not a fault. All of these live in one place: Finder > Settings, then the Tags tab.

The tag is missing from the sidebar

Each tag in that list has a checkbox on the right. Only tags with the box selected appear in the sidebar. Renamed or newly created tags are not always selected.

The tag is missing from the right click menu

The shortcut menu shows only the Favorite Tags section at the bottom of the Tags settings, and Apple's guide states there can be up to seven tags there. A tag outside that section exists but has to be reached through the Tags item in the menu. Drag the tag over one of the favourites to swap it in.

The keyboard shortcuts tag the wrong thing

Apple's guide documents Control 1 through Control 7 to add or remove favourite tags and Control 0 to remove all tags. These follow the order of the Favorite Tags section, so reordering that section changes what each shortcut does. If the shortcuts do nothing at all, check that no other app has claimed Control with a number key in System Settings > Keyboard > Keyboard Shortcuts.

Colours look wrong, or two tags share a colour

There are seven colours plus no colour, and each can carry any number of text labels. Finder searches and lists by the label, not the colour. A file tagged "Clients" in red and another tagged "Urgent" in red show the same dot but appear under different tags. When tags look inconsistent, open the Tags settings and compare labels before assuming data is missing.

The column is not visible in List view

In List view, Control click a column header and select Tags to show a Tags column. Sorting by that column makes it obvious which files carry a tag and which do not, across a whole folder at once.

Step 3: search and the sidebar tag view return nothing

This is the most common complaint in forum threads, and the one where the file is usually fine. The sidebar tag view and a tag search both ask Spotlight. If Spotlight has not indexed the folder, the answer is empty.

Start in Terminal:

mdutil -s /

The output says whether indexing is enabled for the startup volume. "Indexing disabled" explains an empty tag view immediately. An external drive is checked by replacing / with its path under /Volumes.

If indexing is enabled, check the three places where Spotlight is told to ignore something:

1. Search result categories. In System Settings, open Spotlight (or Siri and Spotlight on older versions) and make sure the category of the file is ticked. Oakley points out that an unticked category is still indexed but never appears in results.
2. Excluded locations. The privacy list in the same settings excludes whole folders. A tagged project inside an excluded folder will never show up in the tag view.
3. Paths Spotlight skips by design. Folders whose names start with a dot are invisible to Finder and skipped. Oakley also reports that recent macOS versions, Sequoia included, generally exclude files inside /Library and ~/Library. Tags on files kept there will not appear.

To ask the index directly, without Finder in between, run a tag query in Terminal:

mdfind "kMDItemUserTags == 'Red'"

It lists every indexed file carrying that label. If a file shows the tag in Get Info but is missing from this list, the index is the problem, not the tag. A comment under Oakley's article adds one known gap: mdfind does not list hidden items such as folders whose names start with a dot, even when they are tagged.

Once those are ruled out, test with a fresh file: create a text file in Documents, give it a new tag, wait a minute, then click that tag in the sidebar. If the new file appears and the old ones do not, the old files are in a location Spotlight skips. If nothing appears, Spotlight itself needs attention, and rebuilding the index becomes a reasonable step.

Step 4: tags disappear after copying, syncing or restoring

Tags are preserved reliably when files move between APFS or HFS+ volumes on the same Mac. Outside that, the picture is mixed. In the comments on his article, Oakley names NFS as a well known file system that does not preserve them, and notes that some other network file systems and cloud storage services may not either.

Practical checks by destination:

• iCloud Drive. Tags sync across Macs and appear on iPhone and iPad. Oakley's test is to tag a file in iCloud Drive and confirm the change appears on another device on the same Apple Account. If it does not, the problem is iCloud sync, not tags.
• External drives formatted as exFAT or FAT. These keep extended attributes in hidden companion files. Copying the visible file alone, or cleaning the drive with a tool that deletes hidden files, separates the tag from the file.
• NAS shares. Behaviour depends on the protocol and the server. A disk image (sparse bundle) stored on the share keeps an APFS or HFS+ file system inside, so tags in it survive.
• Archives. A zip made with Finder's Compress command stores attributes alongside the files, so another Mac that expands it gets the tags back. A zip made by other tools may not.

Before relying on tags across a new storage route, tag one test file, send it through the route, and run xattr -l on the copy at the other end.

When the tag is doing a job tags are bad at

Many tag problems are really a design problem. Tags are being used to say "these files belong to project A" when the files live in four different places, and the tag view is the only way to see them together. That depends on every file being tagged by hand, on every location being indexed, and on every storage route preserving attributes. Any one gap makes files silently vanish from the view.

For grouping by project, it is often more robust to group the places rather than the files. A Smart Folder in Finder (File > New Smart Folder) saves a search and still depends on Spotlight. A file manager whose sidebar can hang folders from different disks under one project name does not depend on tags or the index at all, because it points at folders instead of searching for labels. The features page shows that approach, including smart folders and display names that differ from the folder on disk, and the comparison with other file managers covers where Finder still does the job better.

Tags remain the right tool for status across folders: "to review", "sent", "waiting". Short lists with a clear meaning, kept to the seven favourites, fail least often.

What to change first

Run Get Info and mdutil -s / before anything else, because those two checks place the problem in one of the four layers within a minute. If tags are standing in for project folders, try grouping the folders themselves in Atriens and keep tags for status only.