Spotlight usually just works, which makes it confusing when it doesn’t. You type the exact name of a file you saved yesterday and get nothing, or Finder search shows results from everywhere except the folder you care about.

Most problems come down to one of three things: Spotlight is told not to look somewhere, it is looking in the wrong scope, or its index is incomplete. The fixes below go roughly from quickest to most thorough. Try them in order and test after each one.

A quick way to test whether Spotlight knows about a specific file is to search its exact name in Terminal:

mdfind -name "budget-2026"

If the file appears here but not in the Spotlight window, the index is fine and the problem is a display setting (fixes 2 and 3). If it doesn’t appear here either, the file isn’t indexed (fixes 4 to 9).

1. Give it a minute after big changes

After a macOS update, migrating to a new Mac, restoring from a backup or copying a large folder, Spotlight re-indexes in the background. Until it finishes, results are incomplete. If you have just done any of those, wait, keep the Mac awake and plugged in for a while, and try again before changing anything.

2. Check which result categories are turned on

Spotlight only shows the kinds of results you have selected.

Open System Settings ▸ Spotlight.
Look at the list of search result categories. Only selected categories appear in Spotlight results.
Make sure the ones you expect, such as documents, folders, PDFs or images, are turned on.

This affects the Spotlight window (⌘Space). It is a common cause of "Spotlight finds apps but no documents".

3. Check Finder’s search scope

Finder search has its own setting for where to look:

In Finder, choose Finder ▸ Settings ▸ Advanced.
Under When performing a search, choose Search This Mac, Search the Current Folder or Use the Previous Search Scope.

If it is set to the current folder, a search started in Downloads will never find something in Documents. After you start a search, you can also click This Mac or the folder name just below the toolbar to switch scope.

4. Remove the folder from Search Privacy

Spotlight skips anything on its privacy list, and items can end up there without you remembering.

Open System Settings ▸ Spotlight.
Click Search Privacy….
If the folder or disk you are searching is in the list, select it and click − to remove it.

Spotlight then indexes that location. A large folder may take a while.

5. Make sure indexing is on for the disk

Spotlight indexing can be turned off for a whole volume. Check its status in Terminal:

mdutil -s /

You should see Indexing enabled. If it says indexing is disabled, turn it back on:

sudo mdutil -i on /

For an external drive, replace / with its path, for example /Volumes/Archive. Note that some external drives and many network shares aren’t indexed by your Mac at all, so Spotlight can’t search them the same way it searches your internal disk.

6. Include system files when you search for them

By default, Finder searches leave out system files, which covers much of what lives in Library folders. If you are looking for a preference file, a log or something inside ~/Library, add the right criterion:

Start a search in Finder and click + below the search bar.
Open the first menu, choose Other…, and enable System files.
Set it to are included.

To open the Library folder itself, hold Option and open the Go menu, or use Go ▸ Go to Folder and type ~/Library.

7. Re-import a specific file or folder

If only a few files are missing, ask Spotlight to import them again:

mdimport ~/Documents/Projects

mdimport with a file or folder asks Spotlight to (re)import it using the normal mechanism. It is quick and doesn’t touch the rest of the index.

8. Rebuild the index with the Search Privacy trick

If many files are missing from one disk, rebuilding its index usually helps. The no-Terminal way:

Open System Settings ▸ Spotlight ▸ Search Privacy….
Click + and add the disk (for example Macintosh HD) or the problem folder.
Wait a few seconds, then select it and click − to remove it.

Removing it from the list makes Spotlight index that location from scratch. Searching will be incomplete until it finishes, which can take from minutes to hours depending on how many files you have.

9. Erase and rebuild the index with `mdutil`

The Terminal equivalent, and the most thorough reset:

sudo mdutil -E /

According to its manual, -E erases the local Spotlight store for the volume, and the store is rebuilt as appropriate. You need an administrator password. Like fix 8, expect searches to be incomplete while it rebuilds, and your Mac may be busier than usual for a while.

If none of these work, check the disk with Disk Utility ▸ First Aid, and make sure you have free space: indexing may be delayed when the disk is nearly full, as the mdutil manual notes.

Things that look like Spotlight bugs but aren’t

Searching for text inside screenshots. Spotlight indexes text in documents well, but text that only exists as pixels in an image is a different story. See our guide to searching text inside screenshots.
Searching by where a file came from. Spotlight can do it, but not from the search field; you need a query. See finding a download’s source.
Files in apps’ own libraries. Mail messages, notes and photos live inside app databases. Search them in their apps.

Useful search syntax while you are here

A few things the Spotlight and Finder search fields understand:

kind:pdf or kind:image limits results to a type.
Putting a phrase in quotes searches for that exact phrase.
In Finder, click + below the search bar to add criteria like Kind, Last opened date or Name, then Save the search as a Smart Folder.

An alternative front end

If Spotlight itself works but you find its search field limiting, several apps sit on top of the same index and give you more control. HoudahSpot is a popular choice for precise, multi-criteria searches. Bowerbird, our app, takes a different route: you type a phrase in plain English, such as "pdfs from last week over 5 mb" or "zips in downloads", and it turns into filter chips you can edit. Bowerbird also checks whether Spotlight indexing is enabled and tells you how to fix it if it isn’t, and it falls back to scanning your folders directly in that case. It searches only English phrases, and everything stays on your Mac.

Most of the time, though, one of the nine fixes above will bring your files back.

spotlight
search
troubleshooting
terminal