A client called me last Tuesday in a panic. She'd spent twenty minutes trying to find a signed contract PDF she'd saved that morning, and Spotlight kept returning nothing. The file was right there in Documents — she just couldn't search for it. This happens constantly on macOS, and 9 times out of 10 it's an indexing problem, not a lost file.
Spotlight is the search engine built into macOS. It maintains a hidden database at the root of each drive that catalogs every file, app, email, and metadata value on your Mac. When that database gets corrupted, or when Spotlight's indexer process stalls, search goes dead. Sometimes it's partial — apps work but documents don't. Sometimes it's total.
Work through the steps below in order. Stop the second search starts working again. Most people fix this in the first two steps.
Step 1: The 30-Second Fix — Check the Obvious Stuff First
Before you touch anything, rule out the stupid-simple causes. I've wasted an hour diagnosing a "broken" Spotlight that turned out to be a search scope problem.
- Hit the X in the search bar and start over. Spotlight sometimes gets stuck on a failed query. Clear it and type the filename again, exactly as it appears in Finder.
- Check your search location. Open Finder, hit Cmd+F, and look at the search bar. If it says "This Mac" you're good. If it's set to the current folder only, you'll get garbage results. Click "This Mac."
- Look for a spotlight icon in the menu bar that's greyed out. That means indexing is paused or the volume is excluded.
- Restart the Mac. Yes, really. The
mdworkerandmdsprocesses that handle indexing get wedged after long uptimes, especially on Intel Macs that sleep often with external drives attached.
If search still fails after a restart, move to step 2.
Step 2: The 5-Minute Fix — Rebuild the Spotlight Index via Terminal
This is the real fix for most corrupted databases. You're telling macOS to throw away the existing index for a volume and build a fresh one. It doesn't delete your files — it just rebuilds the catalog.
Open Terminal (Applications > Utilities > Terminal) and run this to see the current indexing status on your boot drive:
mdutil -s /You'll see one of three responses:
Indexing enabled.— Spotlight thinks it's fine. It's probably lying.Indexing disabled.— Someone turned it off. That's your problem.Indexing and searching disabled.— Total shutdown. Common after a failed macOS upgrade.
Now toggle it off and back on. This forces a full rebuild:
sudo mdutil -E /
sudo mdutil -i on /The -E flag erases the existing index. The -i on command re-enables indexing. You'll be prompted for your admin password.
For external drives, replace / with the mount point. On a drive named "Archive" that would be /Volumes/Archive:
sudo mdutil -E /Volumes/ArchiveAfter running this, indexing starts in the background. The menu bar Spotlight icon shows a small dot and a progress bar when you click it. On a drive with 500GB of data, expect 30 to 90 minutes. On a fresh MacBook Air M2 with 100GB used, it's usually under 10 minutes.
Don't panic if search gets worse before it gets better. During a rebuild, Spotlight returns partial results. Wait for the dot to disappear before you judge it.
Step 3: The 15+ Minute Fix — Privacy Tab and Metadata Cleanup
If a rebuild didn't fix it, something is excluding folders from the index, or the metadata importer for a specific file type has crashed.
Check the Privacy list in System Settings
Go to System Settings > Siri & Spotlight > Spotlight Privacy (on Ventura and Sonoma). On Monterey and older it's System Preferences > Spotlight > Privacy.
This list contains drives and folders that Spotlight ignores completely. If your entire home folder or an external drive is listed here, search will never find anything inside it. I saw this last month on a client's MacBook Pro — an old IT guy had added the whole home directory to Privacy to "speed things up" and forgotten about it.
Select anything that shouldn't be there and hit the minus button. If you want to force a rebuild after removing items from this list, add your whole drive to the Privacy pane, wait 10 seconds, then remove it. That trick forces a reindex of the entire volume.
Verify Spotlight is enabled for specific file types
In the same Spotlight settings panel, there's a list of categories (Documents, Mail, Apps, etc.) with checkboxes. If "Documents" got unchecked somehow — rare, but it happens after profile corruption — Spotlight won't return document matches at all.
Reimport the metadata plist
If search works for some file types and not others, the metadata importer is broken. Kill the metadata server:
sudo killall -9 mdworker
sudo killall -9 mds
sudo killall -9 mds_storesmacOS restarts these automatically. Give it 30 seconds, then test search again.
Reset Spotlight's preferences
If nothing else worked, delete the Spotlight preference plist and reboot. This wipes any custom exclusions and search behaviors back to defaults:
rm ~/Library/Preferences/com.apple.Spotlight.plist
rm ~/Library/Preferences/com.apple.spotlight.plistThen reboot. You'll lose custom Siri/Spotlight search preferences, but a corrupted plist is a known cause of "Spotlight returns nothing" after macOS upgrades. Ventura 13.4 and Sonoma 14.1 both shipped with bugs that corrupted this file on some machines.
When to Stop Chasing Spotlight
If you've reindexed, cleared privacy settings, killed the metadata processes, and reset preferences — and search still returns nothing — it's time to look at the drive itself. A failing SSD or an external drive with filesystem errors will produce indexing that never completes. Run First Aid:
diskutil verifyVolume /If that returns errors, back up immediately and address the disk before anything else. Spotlight is usually the canary here — it fails first because it's constantly reading every file on the drive.
One last thing: if you're on a Fusion Drive or an older spinning HDD, your index may just be genuinely slow. Reindexing a 2TB Fusion Drive can take a full day. Go make coffee. Come back tomorrow. It'll be done.