Spotlight Not Finding Your Files? Rebuild the Index
A search that stops finding your files usually means the index went stale. Here is what to check first, how to rebuild it properly, and how to search without waiting for it.
A file you were looking at two minutes ago will not come back in a search. You can see it sitting in the folder, you type its name into the search field, and the results pane stays empty. Nothing has been deleted. Your Mac has lost the map.
Spotlight is the index behind that search, and Finder is only one of the things reading it. When the map goes stale, every search that leans on it goes wrong at the same time.
What Spotlight actually is
Two background processes do the work. One walks the filesystem, the other reads what it finds and writes a short record of each item: name, kind, size, dates, and whatever a file's own format lets it report. Those records are stored on each volume in a hidden folder at the root of the disk.
Keeping a separate copy of the facts is what makes search feel instant. Finder never has to open a single document to answer a question about it. It also means the answer can be wrong. Rename a file while a sync client is rewriting its folder, restore a volume from a clone, or cut the power mid-move, and the map keeps whichever version of events it wrote down earlier.
Symptoms that point at the index
- Searches come back empty for files you can see in Finder, rather than slow or partial.
- Files from this week are missing while files from last year still turn up.
- A file you renamed still answers to its previous name.
- One volume is silent while the rest of the Mac searches normally.
- Results appear, but a whole category is absent, such as images or documents.
Two of the items on that list have nothing to do with staleness. A volume you added to the Privacy list is excluded on purpose, and a result type switched off in settings stays switched off no matter how many rebuilds you run. Check both before anything else, because they take a minute and a rebuild takes a night.
Check the index before you touch it
Start with the Search Results list in System Settings, under Spotlight. Every category there can be toggled, and a category that got switched off takes its files out of every search on the machine.
The Search Privacy tab beside it holds the places Spotlight is told to stay out of. A volume sitting in that list is the most common reason a drive goes quiet, and it is easy to add one by accident when you meant to exclude a single folder.
The status takes one command. sudo mdutil -s / prints whether indexing is enabled or disabled for the startup disk, and sudo mdutil -as reports every mounted volume. Neither changes anything. They answer the question the settings pane cannot: is the scan running at all.
During a rebuild, two processes named mds and mdworker sit near the top of Activity Monitor. Seeing them work hard is normal. Seeing them work hard every day on a machine nobody is filing anything into suggests something keeps invalidating the records.
That work needs somewhere to write. A disk close to full can stall a rebuild for days, so it is worth seeing where the space went first. DiskBrew draws it as rings you can drill into.
A menu bar monitor is worth setting up at this point, because the interesting question is usually when the scanning started rather than whether it is happening now. RobuStats shows CPU, memory, and disk activity as live charts one click away, so a pass that begins at three in the morning is something you notice the next day.
Two ways to rebuild
The direct route is Terminal. sudo mdutil -E / erases the index for the startup disk and starts a fresh one. Add -i on if indexing was switched off, as in sudo mdutil -i on /.
The route without Terminal gets the same result. Add the disk to the Search Privacy list, close the window, then open it again and remove the disk from the list. Everything is thrown away and rebuilt, and you never touch a command line.
Expect hours on a drive with a few hundred thousand files. The machine gets warm and the fans spin up, which is worth knowing in advance so it does not read as a fault, and a small progress indicator appears when you click the Spotlight item in the menu bar. Leave the Mac plugged in. If you are stepping away, AwakeBean holds sleep off until the job finishes instead of letting the machine nod off in the middle of the scan.
Do it once, not twice. A second run restarts the clock.
When a rebuild is the wrong move
Erasing an index on a disk with almost nothing left is how a slow search turns into a machine that will not boot. Delete what you are not using first. DripCleaner finds the caches and forgotten folders worth removing and deletes nothing until you approve it.
If the rebuild starts by itself every few weeks, the corruption is probably a symptom. DiskSpeed measures the real read and write speeds of the drive, and a solid state drive that has dropped well below its own numbers is a drive to replace rather than a database to repair.
Folders you never search are worth excluding. A build directory, a video project's render cache, a downloads folder with years of installers in it: add the folder to the Privacy list and the scan stops spending its day on files you will never query. Less heat, less disk activity, nothing lost.
Searching while you wait
There is a second option here, and a machine that has just lost its index is a good moment to notice what an index cannot do.
FileSearch reads the records your Mac already keeps, so there is no first run to wait through, no database of its own parked on the disk, and no setup wizard. Type part of a name and results fill a real table you can sort by name, kind, size, or date, narrow to documents or images or archives with one click, or match with a wildcard when you know the shape of what you want. When you point it at somewhere the scan does not cover, such as a network share or a folder you excluded, it reads the folder directly and says so in the status bar. That detail matters more than it sounds: an empty result means the file is not there, rather than that nobody checked.
FileSteep covers the jobs that were never about file names. It searches inside documents for a phrase, shows previews of almost anything in the window, compares two folders, finds duplicates, renames hundreds of files in one pass, and opens a terminal in the folder you are looking at. Both apps sit on the Frappe shelf, alongside the rest of the local tools.
A search box that works on a plane, with the Wi-Fi off and nothing to ask, is one of the better things about a Mac. Search is also one of the few features on the machine that never phones home: the records live on your own disk, and the repair belongs to you when something goes wrong. Watch it from the menu bar and a stale index stays a chore rather than a mystery.
If the machine is also running hot while it reindexes, Mac Fan Running Loud? 8 Things to Check covers the rest of the causes, and How to Free Up Disk Space on Mac Without Bloated Cleaner Apps goes deeper on the space side.
Every app mentioned here is included in the getapps.cafe membership: 127 native apps for macOS and Windows, from $4.99 a month billed yearly or $9.99 monthly. There is a 7-day free trial at getapps.cafe/membership.