Pressing Command + Spacebar to open an app or locate an important document only to see a blank search bar or a progress bar stuck on "Indexing..." brings your daily productivity to a grinding halt.
Over my eight years of reviewing MacBooks, testing macOS beta builds, and troubleshooting hardware performance on my bench, Spotlight Search has remained the core central nervous system of Mac productivity. When it works, launching software or pulling up documents happens in milliseconds.
However, when Spotlight freezes, your Mac feels sluggish and unresponsive. You hit Command + Spacebar, type the name of an application, and watch in frustration as your Mac returns zero results, missing local files, or endless indexing loops.
Many basic online guides immediately suggest restarting your computer or reinstalling macOS entirely. In my daily device testing and hands-on repair work, I have found that complete operating system reinstalls are rarely necessary. Instead, Spotlight search failures are almost always caused by corrupted metadata database files, frozen mds background daemons, or privacy settings locking out hard drive volumes.
Here is my definitive, field-tested guide to rebuilding your metadata index, resetting background daemons, and restoring instant search functionality on macOS.
.jpg "How to Fix Mac Spotlight Search Not Working or Indexing Stuck")
What Causes Mac Spotlight Search to Fail or Get Stuck Indexing?
.jpg "How to Fix Mac Spotlight Search Not Working or Indexing Stuck")
Before diving into repair methods, it helps to understand how macOS handles local search indexing. Spotlight relies on a hidden background daemon named mds (Metadata Server) and its worker process mdworker.
1. Corrupted V100 Metadata Databases
Spotlight stores file indexing parameters in a hidden system directory called .Spotlight-V100 at the root of your hard drive. If your Mac shuts down unexpectedly during a heavy file transfer or software update, this index database can corrupt, locking Spotlight into an infinite re-indexing loop.
2. Frozen Metadata Server Daemons (mds and mdworker)
Background processes manage file scanning continuously. If a third-party app creates thousands of temporary cache files or broken code loops, the mds daemon can hang, causing CPU usage to spike while search results stay blank.
3. Excluded Hard Drive Volumes in Privacy Settings
If your main hard drive volume or user directory was accidentally added to Spotlight's privacy exclusion list, macOS strictly blocks the indexer from scanning those folders, preventing files from showing up in search queries.
Step-by-Step Fixes to Restore Mac Spotlight Search
Work through these bench-tested troubleshooting steps sequentially to rebuild your search index and clear frozen background processes.
Step 1: Force Re-Index via macOS System Settings
The cleanest graphical method to trigger a complete index rebuild is using the built-in Privacy & Security menu to exclude and re-add your hard drive.
Click the Apple logo in the top-left corner of your screen and select System Settings.
Scroll down the left sidebar and click Siri & Spotlight.
Scroll to the very bottom of the right panel and click the Spotlight Privacy button.
Drag your main hard drive icon (usually named Macintosh HD) or your user folder into the privacy exclusion list.
Click Done to save. This action forces macOS to purge its active search index for that drive.
Re-open the Spotlight Privacy menu, select Macintosh HD, and click the minus (–) button to remove it from the exclusion list.
Click Done. Spotlight will immediately begin scanning your drive to build a fresh, uncorrupted index.
Step 2: Rebuild the Spotlight Index Using Terminal Commands
If the graphical privacy menu fails to restart the indexing process, the command-line utility mdutil provides direct control over the Metadata Server.
Open Terminal from your Applications > Utilities folder (or press Command + Spacebar if basic app launch works).
Type
sudo mdutil -E /and press Return.Type your Mac administrator password when prompted and press Return (note: Terminal will not display characters as you type).
Terminal will output a message confirming that the store index was erased and re-indexing has begun.
To check the active indexing status, type
sudo mdutil -s /and press Return.
For comprehensive technical documentation on managing system search services and indexing properties, review the
Step 3: Force Restart Metadata Server Daemons
If your indexing progress bar remains stuck indefinitely without making progress, killing the background mds process will force macOS to reload clean background threads.
Open Activity Monitor from Applications > Utilities.
In the top-right search box, type
mds.Select mds and mdworker processes from the list.
Click the Stop (X) button at the top of the window and select Force Quit.
Alternatively, open Terminal, type
sudo killall mds, and press Return.macOS will automatically launch fresh instances of the metadata daemons within seconds.
Step 4: Delete Hidden Spotlight Database Files in Safe Mode
If deeply corrupted metadata files resist Terminal reset commands, booting into Safe Mode clears system caches and lets you remove the database manually.
Shut down your Mac completely.
On Apple Silicon Macs (M1/M2/M3), press and hold the Power button until "Loading startup options" appears, select your drive, hold Shift, and click Continue in Safe Mode. On Intel Macs, hold Shift while powering on.
Open Terminal in Safe Mode and type:
sudo rm -rf /.Spotlight-V100Press Return, enter your admin password, and restart your Mac normally.
Upon rebooting, macOS will detect the missing index directory and generate a completely clean database.
Frequently Asked Questions (FAQ)
How long does it take for Mac Spotlight to complete re-indexing?
Depending on your Mac's storage size and whether you use a high-speed SSD or an older mechanical hard drive, re-indexing typically takes anywhere from 15 minutes to 2 hours. You can track progress by opening Spotlight (Command + Spacebar) and looking for the progress bar.
Why is my Mac fan running fast while Spotlight is indexing?
During a full index rebuild, the mds_stores and mdworker processes analyze millions of local files, requiring heavy CPU processing power. Once the index build reaches 100%, processor usage and fan speeds will return to silent baseline levels.
Will rebuilding the Spotlight index delete any of my personal files?
No. Rebuilding the Spotlight index only clears the hidden search catalog and metadata references. Your personal documents, photos, applications, and system files remain completely untouched.
Why does Spotlight find applications but fail to find local documents?
This usually occurs when specific category checkboxes are turned off in settings. Go to System Settings > Siri & Spotlight and scroll down to the Search Results list to ensure categories like Documents, Images, and PDF Documents are checked.