Spotlight problems

The find-anything checklist

Updated 2026-07-31 · 5 min read

Every cause from across this site, in one place, in the order worth checking.

Start here (30 seconds each)

1. The app's Open Recent — the file, and its real location, in one click
2. ⌘-click the title bar of an open document — shows the full path
3. Search by date, not name — ⌘F → Last modified → today/this week, sorted newest first
4. Try a fragment — one distinctive word, not the full name you half-remember

Is it excluded from search?

1. ~/Library? — Mail, Messages, Notes, app data. Hold Option → Go menu, or find ~/Library
2. Inside a package? — Photos originals, iWork images, Logic media. Show Package Contents
3. On an unplugged drive? — Spotlight forgets unmounted volumes entirely
4. In the Trash? — or an app's own Recently Deleted (Photos, Notes, Messages...)
5. On the Spotlight Privacy list? — System Settings → Siri & Spotlight → Spotlight Privacy

Is search itself broken?

1. Check index status — mdutil -s /; rebuild if wrong: sudo mdutil -E /
2. Mid-reindex? — after an update, search is unreliable for hours; wait
3. Categories unchecked? — Siri & Spotlight; an unticked type returns nothing
4. Content search failing? — scanned PDF with no text, or a missing importer

Is it a sync or cloud issue?

1. iCloud placeholder? — name searchable, contents not until downloaded
2. Desktop/Documents synced? — real path is under ~/Library/Mobile Documents
3. In a cloud app's container? — Slack, WhatsApp, Books hide files in ~/Library

The Terminal fallbacks (always work)

1. **find ~ -iname "*fragment*"** — reads the disk directly, no exclusions
2. mdfind -onlyin ~/Library "term" — reaches what Spotlight's UI hides
3. find ~ -mmin -30 — everything touched in the last half hour

If it is genuinely gone

1. Time Machine and local snapshots — the file at its old path
2. Cloud version history — Dropbox, OneDrive, app Versions
3. The original source — re-download, re-save the attachment, check the camera

The pattern behind all of it

macOS search is a curated view, not a complete one. Most "missing" files are in one of four excluded places — Library, packages, unmounted drives, or the Trash — not gone. Knowing the four turns a panic into a checklist, and the checklist almost always ends with the file.

Common questions

What is the first thing to try when a file is missing on a Mac?

The app's Open Recent menu — it names the file and reveals its real location in one click, faster than any search.

Where are files that Spotlight refuses to find?

Usually one of four excluded places: ~/Library, inside a package, on an unmounted drive, or in the Trash. Rarely actually gone.