Spotlight not finding files on Mac: fixes, and how to find a file when you forgot its name
When Spotlight or Finder search can’t find a file on your Mac, check the easy causes first. Make sure the search covers This Mac and not just the current folder, then look for the folder in Spotlight’s Search Privacy list, check indexing with mdutil -s /, and rebuild the index if it is damaged. If you forgot the file’s name, search by kind, date and size instead.
Spotlight is the search system built into macOS. Finder search, the Recents list and the Spotlight bar (⌘ Space) all read from its index, so when that index is stale, switched off or told to skip a folder, all of them miss the same files.
The first half of this guide lists the fixes from quickest to heaviest. The second half covers finding a file when you can’t remember what it’s called. The steps apply to macOS Sonoma 14, Sequoia 15 and later.
- Check the search scope first. Finder may have searched only the open folder.
- Folders in Spotlight’s Search Privacy list never show up in results.
- Rebuild the index only after the quicker checks fail. A rebuild can take hours or even days.
- If you’ve forgotten a file’s name, search by kind, date, size or source, and check Recents, Downloads, the Trash and Time Machine.
Why is Spotlight not finding files on my Mac?
Spotlight misses a file for one of two reasons: the search looked in the wrong place, or the file is not in Spotlight’s index. The index is the database macOS keeps of each file’s name, type, dates and text, so Spotlight can answer without reading the disk.
In practice that comes down to six causes: a search limited to the current folder, results flooded by content matches, a folder in the Search Privacy list, indexing that is off or unfinished (common after a migration or when you connect a new drive), a damaged index, or a file in a place Spotlight treats differently, such as a Library folder, an external drive or iCloud.
How do I fix Spotlight and Finder search not working?
Work through these fixes in order and test a search after each one. The first three take seconds; the last one rebuilds the whole index.
1. Search This Mac instead of the current folder
Finder search scope is where a Finder window search looks: your whole Mac, or only the open folder. If you press ⌘ F in Documents with the scope set to the current folder, Finder never looks at Desktop or Downloads. If the scope bar under the toolbar shows the folder’s name highlighted, click This Mac.
To change what Finder searches by default:
- Click the Finder icon in the Dock, then choose Finder › Settings (⌘ ,).
- Click Advanced.
- Set When performing a search to Search This Mac. The other choices are Search the Current Folder and Use the Previous Search Scope.
On macOS Monterey 12 and earlier the same setting is under Finder › Preferences.
2. Match the file name, not the contents
By default, Finder and Spotlight match your words in file names and inside the text of documents. Searching for “budget” can return every spreadsheet and email that mentions a budget, and the file called Budget 2026.xlsx can get lost among them. To search names only:
- In a Finder window, type your word, then choose Name matches: budget from the menu that appears under the search field.
- In Spotlight or Finder, type
name:budget. Apple documentsname:,title:,author:,from:andtag:as search keywords.
Spotlight matches the start of words, so “port” finds “Portfolio” but not “Report.pdf”. If you only remember the middle of a name, use a disk-scanning tool from the comparison further down.
3. Check Spotlight’s Search Privacy list
Search Privacy is a list of folders and drives that Spotlight does not index, so nothing inside them ever appears in results. It’s easy to add a folder there once and forget about it years later.
- Choose Apple menu › System Settings.
- Click Spotlight in the sidebar. On some earlier versions the pane is called Siri & Spotlight.
- Click Search Privacy (called Spotlight Privacy on some earlier versions).
- If the folder or drive you need is listed, select it and click the remove button (–). Spotlight starts indexing it.
In the same pane, check that the result categories you need, such as Documents, Folders or Images, are turned on. A category that is off can hide those files from the Spotlight bar.
4. Check that indexing is on and finished
The mdutil command is Apple’s Terminal tool for managing Spotlight indexes. Open Terminal (in Applications › Utilities) and run:
mdutil -s /
On a healthy Mac it replies Indexing enabled. If it says indexing is disabled, turn it back on with:
sudo mdutil -i on /
To see every mounted volume at once, including external drives, use mdutil -sa. While indexing runs, processes named mds, mds_stores and mdworker_shared use CPU in Activity Monitor, and results stay incomplete. Apple says indexing finishes sooner when the Mac is idle and connected to power.
5. Rebuild the Spotlight index
Rebuilding the Spotlight index throws away the old database and builds a new one. It fixes searches that miss files you can see, show long-deleted files or return nothing. Apple’s documented method uses the privacy list:
- Open System Settings › Spotlight › Search Privacy (or the older names above).
- Drag Macintosh HD, or the folder that isn’t searchable, into the list, or click the add button (+) and choose it.
- Wait a few seconds, select the same item in the list and click the remove button (–).
- Click Done and quit System Settings. Spotlight reindexes that disk or folder.
If you see an “unknown” error or a permissions error, your user account might not own some of the items in that location. Apple’s article on rebuilding the Spotlight index on your Mac has the full steps.
The Terminal equivalent erases the index for the startup disk, and Spotlight then builds it again:
sudo mdutil -E /
Plan for the time. A full rebuild of the startup disk can take hours, and Apple notes that indexing can take days on a disk with a lot of data. Search and the Finder Recents list stay incomplete until it finishes. Start it at the end of the day with the Mac plugged in, and leave it awake.
Why can’t Spotlight find files on external drives, iCloud or Library folders?
Spotlight treats some locations differently from your home folder, so even a healthy index can miss files there.
External and network drives
Spotlight indexes each drive separately. Run mdutil -s /Volumes/DriveName (replace DriveName with the drive’s name as it appears in Finder). If indexing is disabled, run sudo mdutil -i on /Volumes/DriveName. Network shares and some drives formatted for Windows may not be indexed at all, so a search tool that scans the disk directly is the better option there.
iCloud Drive with Optimize Mac Storage
Optimize Mac Storage is the iCloud Drive setting that keeps rarely used files only in iCloud and leaves a placeholder on your Mac when space runs low. Those files still show up when you search by name, but in independent tests their contents were not searchable until the file was downloaded again. To fix one folder, Control-click it in Finder and choose Download Now. To keep everything local, turn off Optimize Mac Storage in the iCloud Drive settings under your name in System Settings. Your Mac needs enough free space for that.
Library folders and hidden files
Spotlight and Finder leave system files out of search results by default. The Library folder in your home folder is hidden, and Howard Oakley’s tests on macOS Sequoia found that Spotlight holds back results from most Library folders even when they are indexed. To look there:
- Open the folder directly: in Finder, hold ⌥ and open the Go menu, then choose Library. Search from inside it with the scope set to that folder.
- In a Finder search, click the add button (+), choose Other from the first pop-up menu, add System files, and set it to are included.
- Press ⇧ ⌘ . in a Finder window to show or hide hidden files.
After a migration, restore or major update
After Migration Assistant, a Time Machine restore or a major macOS upgrade, Spotlight indexes everything again, and searches stay patchy until it finishes. Give it a day, then rebuild the index if files are still missing.
Spotlight and Finder search troubleshooting table
| Symptom | Likely cause | Fix |
|---|---|---|
| Finder search finds files in one folder only | Scope set to the current folder | Click This Mac, or change Finder › Settings › Advanced › When performing a search |
| Hundreds of results, but not the file you want | Matching contents as well as names | Choose Name matches, or type name: before the word |
| Nothing from one folder or drive ever appears | Folder is in Search Privacy | Remove it from System Settings › Spotlight › Search Privacy |
| Recent files missing, Recents nearly empty | Indexing still running or switched off | Check mdutil -s /; wait, or turn indexing on |
| Search shows deleted files or misses files you can see | Damaged index | Rebuild the index (Search Privacy add and remove, or sudo mdutil -E /) |
| Files on a USB or network drive not found | Drive not indexed | sudo mdutil -i on /Volumes/DriveName, or use a disk-scanning tool |
| iCloud file found by name but not by words inside it | File is only in iCloud | Download Now, or turn off Optimize Mac Storage |
| Preferences or app support files not found | Library and system files are left out | Search from inside Library, or add System files › are included |
| Search incomplete after setting up a new Mac | Initial indexing after migration | Leave the Mac on power for a few hours, then try again |
How do I find a file on Mac when I forgot the name?
To find a file whose name you’ve forgotten, search by what you remember: when you used it, what kind of file it is, how big it is, which app opened it or where it came from. Start with the lists macOS keeps, then build a search with criteria.
Check Recents and Recent Items
- Finder Recents (⇧ ⌘ F, or Go › Recents) lists files you opened recently, newest first. It runs on the Spotlight index, so it is only as good as the index.
- Apple menu › Recent Items lists recent documents and apps. You set how many it shows with Recent documents, applications, and servers. That setting is in System Settings › Menu Bar on recent macOS, and under Control Center on Sequoia and Sonoma.
- File › Open Recent in the app you used, such as Pages, Word or Preview.
Sort Downloads by Date Added
Many “lost” files are downloads with a name you never saw. Open Downloads (⌥ ⌘ L), then choose View › Sort By › Date Added. If you remember the website or email it came from, our guide on seeing where a file was downloaded from on a Mac shows how to read that information.
Search by kind, date and size in Finder
A Finder search with criteria finds files by their properties instead of their name. A file must match every row you add.
- In Finder, press ⌘ F and make sure This Mac is selected.
- Click the add button (+) on the right, below the search field.
- Set the first row to Kind is and pick a type, such as PDF, Presentation, Image or Movie.
- Add another row and choose Last opened date, Last modified date or Created date, then within last and a number of days, weeks or months.
- For size, choose Other in the first pop-up menu, select File size, then set is greater than or is less than.
The Other list holds dozens more attributes, such as Date added, Pages, Pixel width and Authors. Hold ⌥ and click the add button to get a row with Any, All or None, which works like OR, AND and NOT. Apple’s guide to narrowing your search results in Finder covers each control.
Use Spotlight search keywords
Spotlight accepts the same kind of filters typed straight into the search bar, which is faster than building rows:
kind:pdf invoicefinds PDFs that mention “invoice”. Other kinds includekind:image,kind:movie,kind:presentation,kind:folderandkind:music.date:todaylists items from today.author:Mariaandtag:Redmatch those attributes.trip -francefinds items about a trip that don’t mention France. You can also type OR between words.- Plain phrases such as “presentations from last week” or “images from last year” have worked in Spotlight for many years, though how well they work varies by macOS version.
Save the search as a Smart Folder
A Smart Folder is a saved Finder search that updates itself as files change. Choose File › New Smart Folder, add your criteria, then click Save and keep Add To Sidebar selected. A Smart Folder such as “PDFs opened in the last 30 days” works like a Recents list for one kind of file.
Look in the Trash and Time Machine
If the file might have been deleted, open the Trash from the Dock. Control-click a file and choose Put Back to return it to its original folder. If Remove items from the Trash after 30 days is on in Finder’s Advanced settings, older items are already gone.
If you use Time Machine, open the folder where the file used to be, then choose Browse Time Machine Backups from the Time Machine menu in the menu bar, or open the Time Machine app. Go back to a date when the file existed, select it and click Restore.
What can I use when Spotlight still can’t find the file?
When the built-in tools aren’t enough, pick a tool by what’s wrong. For more precise searches over a healthy index, use an app that builds on Spotlight. For files that aren’t indexed, use one that reads the disk directly. If you remember what a file was about but not its name, FindGlance, a Mac app for finding and tidying files, searches by description and by the text inside images.
| Tool | How it searches | Best for | Cost |
|---|---|---|---|
| Spotlight and Finder | The Spotlight index | Everyday search by name, kind, date and content | Built in |
| HoudahSpot | Builds on the Spotlight index; needs indexing turned on | Detailed searches with many criteria, several folders at once, saved templates | Paid, with a free trial |
| EasyFind | Scans the disk directly, no index needed | Drives and folders Spotlight doesn’t index; partial names; regular expressions | Free |
| FindGlance | Its own on-device index of the folders you allow | Describing a file in plain English; text in screenshots and PDFs; finding files by download source | Free 7-day trial, then a one-time Pro license |
HoudahSpot suits people who like Finder’s criteria rows but want more. It adds criteria groups, content search with exact phrases, searching several folders at once with exclusions, and reusable templates. Because it builds on Spotlight, it can’t see files Spotlight hasn’t indexed. EasyFind from DEVONtechnologies works the other way. It doesn’t need an index, so it can find files in places Spotlight skips, though scanning a disk takes longer than looking up an index. It supports wildcards, Boolean operators and regular expressions. For file managers, see our comparison of the best Finder alternatives for Mac.
How does FindGlance help when you remember a file but not its name?
FindGlance is a Mac app for finding and tidying files that shows images, videos, music, documents, archives and apps as large thumbnails, and it works alongside Finder. We built FindGlance for the moment this guide ends with: you know the file exists, you remember something about it, and the name is gone.
- Describe the file in plain English. Press ⌘ F and type “slides from march”, “invoice from gmail” or “big videos older than a year”. FindGlance shows how it read your words as Understood as chips for From, Kind, Date, Size and Sort. You can adjust any chip if it guessed wrong.
- Search the words inside screenshots, photos and PDFs. FindGlance reads text in screenshots and photos with Apple’s Vision text recognition on your Mac and searches the text inside PDFs, so “screenshots with tracking number” finds the screenshot even though its file name is just a date. The first text scan after each launch takes 15 to 30 seconds while macOS loads its recognition model. Our guide to searching the text inside screenshots on a Mac covers this in detail.
- Find files by where they came from. The Downloaded From view (⇧ ⌘ J) groups files by source, such as Gmail, WhatsApp, Slack, ChatGPT or any other website, using the web address macOS saves with each download.
The limits matter too. FindGlance searches the folders you allow in its settings, such as Desktop, Documents and Downloads, not system files. It keeps its own index on your Mac rather than relying on Spotlight’s, and it doesn’t repair Spotlight, so the fixes earlier in this guide still apply. Indexing, text recognition and search all run on the Mac, and nothing is uploaded. Files stored only in iCloud are skipped for text recognition.
FindGlance runs on macOS Sonoma 14 or later. The 7-day free trial includes every feature, with no account, card or email. After that, FindGlance Pro is a one-time purchase rather than a subscription.
Frequently asked questions
How long does it take to rebuild the Spotlight index on a Mac?
Rebuilding the Spotlight index for a startup disk usually takes a few hours, and Apple notes that indexing can take days when a disk holds a lot of data. It finishes sooner when the Mac is idle, plugged in and awake. Searches and the Finder Recents list are incomplete until it is done.
Is it safe to run sudo mdutil -E / on a Mac?
Yes. The command sudo mdutil -E / erases only the Spotlight index for the startup disk, not your files, and Spotlight then builds a new index. The only cost is time: search results are incomplete until reindexing finishes, which can take hours.
Why is Recents empty in Finder on my Mac?
Finder Recents is built from the Spotlight index, so it looks empty or incomplete when indexing is switched off, still running after a migration, or damaged. Run mdutil -s / in Terminal to check that indexing is enabled, give a running index time to finish, and rebuild the index if Recents stays empty.
Can Spotlight search the text inside PDFs and documents?
Yes. Spotlight indexes the text inside PDFs and common document formats, so a search can match words in a file even when they are not in its name. Files excluded in Search Privacy, and iCloud Drive files that are not downloaded, may not match by their contents.
Does Spotlight search external drives?
Spotlight can index external drives, but it indexes each drive separately and indexing can be turned off for one. Check with mdutil -s /Volumes/DriveName in Terminal and turn it on with sudo mdutil -i on /Volumes/DriveName. Network shares and some Windows-formatted drives may not be indexed, so a tool that scans the disk directly, such as EasyFind, works better there.
How do I make Finder search only the folder I’m in?
Open Finder › Settings, click Advanced and set When performing a search to Search the Current Folder. For a single search, click the folder’s name in the scope bar under the toolbar instead of This Mac.
Why can’t I find a file I just downloaded on my Mac?
Downloaded files often get names you never saw, so searching for the name you expect fails. Open the Downloads folder, choose View › Sort By › Date Added, and the newest arrivals appear first. If the file is still missing, check your browser’s download list or the app you downloaded it in.
Does FindGlance fix Spotlight search?
No. FindGlance is a Mac app for finding and tidying files, and it keeps its own index of the folders you allow rather than repairing Spotlight’s. It helps when you remember something about a file but not its name, such as a description, words in a screenshot or the website it came from.