Rebuild Spotlight Index: What It Is & How to Fix

Rebuilding the Spotlight index on macOS is a troubleshooting step that forces the system to delete and recreate the metadata database Spotlight uses to find files, emails, and apps. You trigger it by adding your startup disk to Spotlight’s Privacy list and then removing it, which causes macOS to re-index the entire drive. This article explains why the index gets corrupted, exactly how to rebuild it, what to expect during the process, and answers common questions about time, side effects, and alternatives.

Why the Spotlight Index Breaks

The Spotlight index is a hidden folder (.Spotlight-V100) at the root of each volume. It stores metadata — file names, contents, dates, tags, and even text inside documents. Normally it updates silently in the background. But several things can corrupt it:

Force-quitting apps or shutting down mid-write
Power loss during an update
Third-party cleanup tools deleting index files
macOS upgrades that leave stale entries
External drives disconnected while indexing

When the index is corrupt, you see missing results, spinning beach balls, or “Searching…” messages that never finish. Rebuilding is the standard fix.

How to Rebuild the Spotlight Index

The official method uses System Settings (macOS Ventura and later) or System Preferences (earlier versions). Here are the steps:

Open System Settings (or System Preferences) → Spotlight.
Click the Privacy tab.
Drag your startup disk (usually “Macintosh HD”) into the list. If you can’t drag, click the + button and select the disk.
Wait a few seconds, then select the disk in the list and click the – button to remove it.
macOS will ask if you want to stop indexing — click OK if prompted, then remove it.
Close System Settings. Spotlight will begin re-indexing the entire drive.

You can also do this from Terminal with sudo mdutil -E / (erase index) and sudo mdutil -i on / (turn indexing back on). The GUI method is safer for most users.

How Long Does Rebuilding Take?

Time depends on drive size, speed, and how much data you have. A typical 256 GB SSD with 100 GB used might take 30–60 minutes. A 1 TB drive with 500 GB of files can take several hours. During this period, Spotlight results will be incomplete or slow, and CPU usage may spike (the mds and mdworker processes run at high load).

You can check progress by typing a known file name in Spotlight — if it appears, indexing is done. Or run mdutil -s / in Terminal to see the index status.

Common Problems and Fixes

Rebuilding usually works, but sometimes it fails or takes too long:

Index never completes: Try erasing the index with sudo mdutil -E / and then restarting your Mac.
Spotlight still shows old results: Reboot after rebuilding to flush caches.
External drives not indexing: Check that the drive is mounted and not in the Privacy list.
Index keeps corrupting: Run First Aid in Disk Utility to check for filesystem errors.
Search is slow even after rebuild: Consider excluding folders you rarely search (like backups) via Privacy.

If you have a Time Machine backup, you can also try restoring the .Spotlight-V100 folder from a backup — but that’s rarely necessary.

Alternatives to a Full Rebuild

Before nuking the whole index, try lighter fixes:

Restart your Mac — sometimes the index just needs a fresh start.
Remove only a problem folder — add a specific folder to Privacy, then remove it to re-index just that folder.
Check disk space — Spotlight needs free space for temporary files; if your drive is nearly full, indexing may stall.
Use mdutil -i off then -i on — this toggles indexing without erasing, which can fix stuck states.

If you use third-party search tools like Alfred, they rely on Spotlight’s index too, so rebuilding fixes them as well.

Frequently Asked Questions

Will rebuilding Spotlight delete my files?

No. The index is just metadata — a catalog of your files. Deleting it does not touch the actual files, folders, or their contents. Your data remains untouched; only the search database is rebuilt from scratch.

Can I use my Mac while Spotlight is re-indexing?

Yes, but expect slower performance, especially if you use apps that read/write many files. The indexing processes run in the background and will yield to foreground apps, but CPU and disk usage will be higher than normal.

Why does Spotlight still show no results after rebuilding?

If indexing is still in progress, results will be incomplete. Wait until the index is built (check with mdutil -s /). If it’s done and still empty, check that the file type is indexed — some file extensions are excluded by default in Spotlight’s settings.

Does rebuilding fix Spotlight not finding emails or contacts?

Yes, because Mail and Contacts are indexed by Spotlight. Rebuilding the index will re-scan those databases. However, if the issue is in the app itself (e.g., Mail’s own search), you may need to rebuild the Mail mailbox separately.

Is there a way to rebuild only part of the index?

Yes. Add a specific folder or volume to the Privacy list, then remove it. Spotlight will re-index only that item, which is much faster than a full rebuild. This is useful if you suspect one folder is causing the problem.

How often should I rebuild the Spotlight index?

Only when you have a problem. Rebuilding unnecessarily wastes time and CPU. If Spotlight works fine, leave it alone. A good rule of thumb: rebuild only after a macOS upgrade if search seems broken, or when you see persistent “Searching…” messages.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →