Spotlight problems

The Spotlight exclusion list

Updated 2026-07-31 · 3 min read

There is a list on your Mac of folders Spotlight has been told to ignore. Most people have never opened it. It is the first thing to check when a whole folder has gone missing from search.

Where it lives

System Settings → Siri & Spotlight → scroll to the bottom → Spotlight Privacy…

On older macOS versions: System Preferences → Spotlight → Privacy tab.

Anything listed there is excluded from results entirely. Remove an entry by selecting it and clicking the minus button.

How folders end up there without you

• Some backup and cleanup utilities add exclusions during setup, to keep their own working

directories out of your results.

• Dragging a folder onto the list is easy to do by accident and gives no confirmation.
• Migration Assistant can carry the list over from an old Mac, including exclusions that

made sense years ago.

The category checkboxes matter too

Higher up the same settings pane is a list of result categories — Applications, Documents, Folders, Mail & Messages, and so on. Unchecking one removes that entire class of result from Spotlight. If applications stopped appearing but documents still do, this is why, and no amount of index rebuilding will fix it.

Verifying from the Terminal

The exclusion list is stored in a system plist that is not comfortably readable, but you can confirm whether a specific path is being indexed:

mdutil -s /Volumes/YourDrive

and test whether a known file is in the index at all:

mdfind -name "yourfile.pdf"

If mdfind returns nothing for a file you can see in Finder, it was never indexed — and an exclusion is the most likely reason.

Common questions

Does removing a folder from the Privacy list re-index it immediately?

It triggers indexing of that folder, which then happens in the background. Give it a few minutes on a large folder.

Can I exclude a folder from Spotlight but still search it another way?

Yes — find and mdfind -onlyin still work on excluded paths, and third-party indexes are unaffected by Spotlight's list.