Troubleshooting & Diagnostics
Spotlight Not Finding Files? Why Mac search fails and how to fix it.
A complete guide to resolving broken Spotlight searches on macOS Sonoma & Sequoia, repairing the mds daemon, and finding files without exact filenames.
Why Spotlight Fails to Surface Your Work
Exact Match Failure
Spotlight requires exact substring keywords. If your file is named with an automated timestamp or random hash, searching general terms yields zero hits.
Corrupted mds Index
After OS updates or sleep transitions, the macOS Metadata Server daemon can freeze or enter an endless indexing loop, locking search queries.
Web & Siri Overload
Spotlight prioritizes Wikipedia entries, web suggestions, and dictionary cards over the actual PDF or document in your ~/Downloads folder.
How to Rebuild the Spotlight Index (Terminal Method)
If Spotlight has stopped returning known local files, you can force macOS to purge the existing catalog and re-index your boot drive using the terminal utility mdutil:
# 1. Check Spotlight indexing status on your boot drive
sudo mdutil -s /
# 2. Erase the existing local Spotlight catalog
sudo mdutil -E /
# 3. If indexing was disabled, re-enable it
sudo mdutil -i on /
sudo mdutil -E /, the process mds_stores will consume background CPU while rebuilding. You will see a progress bar in Spotlight when pressing ⌘ Space until indexing completes.Stop Remembering Filenames: Search by Memory
Even with a healthy index, exact filename search is mismatched with human recall. SearchOnMac solves this fundamentally.
How Spotlight Works
- ✕Requires exact string in filename or file body
- ✕Ignores time context like “downloaded 2 hours ago”
- ✕Cannot jump to open browser tabs or terminal windows
- ✕Zero clipboard history support
How SearchOnMac Works
- Natural memory phrasing: “the pdf from this morning”
- Its own on-device index, with results in about 0.1 s
- Instant tab switching across Arc, Chrome, Safari, Terminal
- Clipboard history built in, kept on your Mac
Frequently Asked Questions About Mac Search Errors
Why does Spotlight suddenly stop finding files on Mac?
Spotlight relies on the macOS Metadata Server daemon (mds). When file system metadata becomes desynchronized after macOS updates, abrupt power losses, or disk permission issues, the index becomes corrupted or stuck. Additionally, Spotlight excludes files if folders were accidentally added to the System Settings Privacy list.
Does rebuilding the Spotlight index delete my files?
No. Rebuilding the Spotlight index only clears and recreates the search catalog database (.Spotlight-V100). Your original documents, downloads, applications, and settings remain completely untouched.
How long does mdutil take to rebuild the Mac search index?
Rebuilding an index on a typical 512GB or 1TB SSD takes between 20 minutes to over an hour depending on file count and CPU availability. During this period, search results are incomplete and Mac battery drain is elevated.
How does SearchOnMac avoid Spotlight indexing issues?
SearchOnMac keeps its own index of your files, separate from Spotlight's, and searches it with time and folder filters, together with your open windows, browser tabs and clipboard history. So when Spotlight's index is broken, SearchOnMac can still find your files.