Spotlight not finding files on Mac: causes and fixes
Updated 20 October 2026
Spotlight usually misses a file for one of four reasons: it is still indexing (Apple says that can take hours or even days after you set up the Mac or install an update), the file’s category is switched off or its folder is excluded in Spotlight settings, the index for that folder needs rebuilding, or the words you typed are not in the file as text. Work through them in that order. Apple documents the first three, and each is a few clicks in System Settings.
First, work out which kind of miss you have
| What you see | Most likely cause | Go to |
|---|---|---|
| Files are missing right after setup or a macOS update | Spotlight is still indexing | Step 1 |
| A whole type of content never appears | The category is off in Spotlight settings | Step 2 |
| Nothing from one folder or disk ever appears | It is excluded under Search Privacy | Step 3 |
| One folder misbehaves though it is not excluded | Its part of the index needs a rebuild | Step 4 |
| It finds the file by name but not by a phrase or a synonym | Spotlight matches the words you type | Step 5 |
| Screenshots and scans never match their text | There is no text to index | Step 6 |
1. Let Spotlight finish indexing
Apple says Spotlight indexes your Mac when you first set it up, after you install a software update or upgrade, and as data changes. Depending on how much you have, that can take hours or even days, and later incremental updates are much faster. It finishes sooner when the Mac is not in use, is connected to power and is online. While it works, an indexing progress indicator shows at the top of the window that opens when you press Command-Space.
If the Mac has not been updated for a while, install the latest macOS update first. Apple lists that as the first thing to try when Spotlight gives unexpected results.
2. Check Spotlight settings
Apple’s advice is direct: if Spotlight is not finding a certain type of content, check whether that type is turned on for Spotlight searches.
- Open the Apple menu, choose System Settings, then click Spotlight in the sidebar. On older versions of macOS it is called Siri & Spotlight, and you may need to scroll down.
- Under Results from Apps and Results from System, turn the categories you want on. Apple says Spotlight shows results from your apps and system as well as their contents, and a category that is off is left out.
3. Check Search Privacy exclusions
The same Spotlight settings page has a Search Privacy button, at the bottom or in the lower right depending on your version, called Spotlight Privacy in some. Anything in its list is excluded from Spotlight searches, and it is easy to forget a folder or a whole disk you added there some time ago.
- Open Search Privacy and read the list.
- Select the folder or disk you are missing files from and click the remove button (−).
- Click Done. Spotlight starts indexing it again.
4. Rebuild the index for one folder or disk
If a folder is not excluded and Spotlight still misses files in it, Apple documents a targeted rebuild. Apple says rebuilding part of the index can help with stubborn search problems affecting certain files within a disk or folder.
- Open System Settings → Spotlight (or Siri & Spotlight) and click Search Privacy.
- Drag the disk or folder you want indexed again into the list, or click the add button (+) and choose it.
- Wait a few seconds, then select it in the list and click the remove button (−).
- Click Done and quit System Settings. Spotlight now reindexes that disk or folder.
If you see an “unknown” error or a permissions error, Apple says your account may not have ownership permissions for some items in that location. A large disk takes a while to reindex, so give it time before you judge the result.
5. Spotlight not searching file contents: how it matches
Spotlight does read inside files: Apple says it shows results from your apps and system as well as their contents. What it does with that text is match words. We tested it on macOS 26.6.2 on 30 August 2026. With a document reading “Annual compensation review”, a search of Spotlight’s index for salary returned nothing, and so did pay, while a search for a word that was in the file found it immediately. We have not re-run that test on macOS 27.
You can run the same check yourself. mdfind queries the same index Spotlight uses, so anything invisible to one is invisible to the other. In Terminal, with an exact phrase you know is in a text document:
mdfind -onlyin ~/Documents "termination notice"If that finds the file, the index is fine and the problem was the words you typed. If it returns nothing for a phrase you know is in a normal text file, go back to steps 1 to 4. Matching is also one language at a time: a German document does not match an English query.
Two more built-in routes are worth knowing. Finder search takes criteria and keywords, and Apple’s own example, trip kind:document, searches for the word “trip” in documents only. And if you only remember when you last had the file, Apple suggests the Finder’s Recents view sorted by Date Last Opened, the Apple menu’s Recent Items, or File → Open Recent inside the app. Our guide to searching inside files on Mac covers Spotlight and mdfind in more detail.
6. When the text is a picture, or the words differ
If the index is complete, nothing is excluded and the words match, the file is usually invisible to Spotlight for a structural reason. A screenshot, a photographed receipt or a scanned contract holds pixels, not text, so there is nothing for the index to store. Apple’s Photos app can search text within photos in its own library, which helps for pictures that live there. And when you remember what a document was about rather than how it was worded, keyword search cannot help, however well it is configured.
If Spotlight finds the file after the steps above, you do not need another tool. If it still does not, search by meaning is the remaining option. BeaconFind is one that runs on Macs with Apple Silicon (an M1 or newer, on macOS 12 or later): you press Option+Space and describe the file, and it searches 70+ file types in 50+ languages, runs OCR over scanned PDFs and screenshots saved as PNG, WebP, BMP or TIFF, and keeps its own index, so Spotlight carries on as before. Your files, their contents, your searches and the index stay on your Mac. The app contacts our servers only for a licence check and an update check, and both can be blocked by a firewall without affecting search. Intel Macs are not supported, it is paid after a 14-day free trial, and the first run downloads the AI models once (roughly 0.8 GB on the lightest tier, up to about 6 GB on the heaviest). The Spotlight alternative guide compares it with the built-in options.
Try meaning-based search on the files Spotlight cannot find. Free for 14 days, no account, no card.
Download BeaconFindFrequently asked questions
Why is Spotlight not finding my files?
Usually one of four reasons: Spotlight is still indexing, which Apple says can take hours or even days after setup or an update; the file's category is turned off in Spotlight settings; the folder or disk is excluded under Search Privacy; or the words you typed are not in the file as text. If none of those apply, rebuild the index for that folder.
How do I rebuild the Spotlight index on a Mac?
Open System Settings, click Spotlight (or Siri & Spotlight), and click Search Privacy (or Spotlight Privacy). Add the disk or folder to the list of locations Spotlight is prevented from searching, wait a few seconds, select it and click the remove button, then click Done and quit System Settings. Apple says Spotlight then reindexes the contents of that disk or folder.
How long does Spotlight take to index a Mac?
Apple says indexing can take hours or even days depending on how much data you have, with much faster incremental updates afterwards. It finishes sooner while the Mac is not in use, is connected to power and is online. A progress indicator shows at the top of the window that opens with Command-Space.
Why does Spotlight find some files but not the text inside documents?
Spotlight matches the words you type, so the words have to be in the file. On macOS 26.6.2, a document reading 'Annual compensation review' was not returned by a search of Spotlight's index for salary or for pay, while a search for a word that was in the file found it at once. A file with no text layer, such as a scan, has nothing to match.
Can Spotlight search inside screenshots and scanned PDFs?
Not reliably. In a screenshot or a scan the words are pixels, not text, so there is no text layer for the index to store. Reading them needs OCR. Apple's Photos app can search text within photos in its own library, but that search lives in Photos.
Can I find a Mac file by describing it instead of remembering its words?
Not with Spotlight, which matches the words you type. Searching by meaning needs a separate tool: BeaconFind does it on Apple Silicon Macs, with the models running on your Mac, and our Spotlight alternative guide compares the options.