Searched as: spotlight not finding screenshots
Spotlight not finding screenshots? Fix it in order
Updated Tested on macOS 26.6.2
Spotlight usually misses a screenshot for one of three reasons: its folder is excluded in Spotlight’s Search Privacy list, the index hasn’t caught up, or the text isn’t in a language Live Text reads. Check the folder first, then indexing with mdutil -s, then the file itself with mdls. Rebuilding the index is the last resort.
You know the screenshot exists. You can picture it, maybe even a word in it, and Spotlight returns everything except that. This guide goes through the reasons in the order worth checking them, starting with the ones that take ten seconds and keeping the heavy fix for last. Everything here uses what macOS already has.
Why can’t Spotlight find a screenshot you know exists?
Spotlight doesn’t search your disk live. It searches an index it builds in the background, and a screenshot can be missing from that index, or present but not matchable by the thing you typed. In practice it comes down to a short list:
- The folder is excluded. Spotlight has a list of places it is told to skip, and a screenshot saved there is invisible.
- The index hasn’t caught up. Apple says indexing happens when you set up a Mac, after an update or upgrade, and as data changes. A new screenshot, or a Mac that just updated, may not be searchable yet.
- You’re searching for text Live Text can’t read. Spotlight can search text in images only for the languages Live Text supports, and only when it recognised the text.
- You’re searching for something macOS never recorded. A screenshot’s file name is a date and a time. Spotlight doesn’t know which app was on screen, so a search for “the one from Figma” only works if the word is visible in the image.
- The type of result is switched off. Apple says that if Spotlight isn’t finding a certain type of content, check whether that type is turned on in Spotlight’s settings.
The sections below take them in the order that costs you the least. If you want the wider picture first, the guide to searching the text in screenshots on a Mac covers what Spotlight can and can’t see when it works.
Is the folder excluded from Spotlight?
Start here, because it is the cheapest check and the most common surprise. Spotlight has a Search Privacy list. Anything in it, folder or disk, is left out of every search.
On macOS Tahoe 26, Apple’s steps are:
- Open System Settings and choose Spotlight in the sidebar.
- Click Search Privacy, in the lower right.
- Look through the list. If the folder your screenshots are saved to is there, select it and remove it.
Excluding a folder also hides everything inside it, so look for any folder above yours in the list too.
If you’re not sure where your screenshots go, press ⇧⌘5, click Options, and read the Save to section. Apple’s screenshot guide describes that menu.
People often end up with an excluded folder by accident. A project folder added to keep it out of searches, an external drive, or a folder dragged in while tidying up can all do it. Apple also warns that excluding files may stop you from receiving update notifications for certain apps, which is worth knowing before you add anything.
Is the index still catching up?
If the folder is fine, ask whether Spotlight has finished looking at the Mac. Apple’s page on Spotlight indexing says that depending on how much data you have, indexing “can take hours or even days”, and that it goes faster when the Mac is idle, connected to power and online over Wi-Fi or Ethernet. That is Apple’s only guidance on timing. It gives no figure for how soon a single new screenshot becomes searchable, and neither will I.
You can ask the Terminal what state the index is in. This command only reads:
Terminal
mdutil -s /
It prints the indexing status of the startup volume. Since macOS Catalina your files sit on a separate Data volume, and mdutil -s /System/Volumes/Data reports that one, also read-only. A Mac whose index is on says Indexing enabled. One where it is off says Indexing disabled., and then Spotlight finds no files on that volume. If yours says disabled and you didn’t choose that, indexing was switched off at some point and the fix is a different one from anything in this guide. Apple support is the place for that.
If it says enabled, leave the Mac plugged in and idle for a while, then search again. Opening Spotlight and finding nothing right after a big update is normal.
Making Spotlight look at a folder again
Apple documents a gentle way to nudge the index without Terminal. Add the folder to the Search Privacy list, wait a few seconds, then remove it. Apple says this makes Spotlight index the folder again. Try this before anything stronger.
Rebuilding the whole index
This is the heavy option, so read the warning before you copy anything. The command erases Spotlight’s index for a volume and builds it again from scratch:
Terminal
sudo mdutil -E /
Per the mdutil manual page, -E causes each local store for the volumes indicated to be erased, and the stores are rebuilt if appropriate. What that means for you:
- Searching is partial until it finishes. Apple says a full pass can take hours or even days, so don’t start it before you need to search.
- It needs
sudo, so it asks for your administrator password. - It can’t be undone, though nothing is lost that can’t be rebuilt. The index is a cache of your files, not your files.
- It only reaches the volume you name.
/is the startup volume.
I haven’t run that command for this guide and wouldn’t suggest it as a first move. Use it when the folder is not excluded, the index status is enabled, and a re-add of the folder changed nothing.
Does Spotlight read text in images?
Yes, with limits. Apple’s iMac guide for macOS Tahoe 26 says it plainly: “With Live Text, Spotlight can search for text in images (available in select languages).” Live Text is the text recognition built into macOS, and Spotlight uses what it finds.
That has some consequences for a screenshot you can’t find:
- Language. Apple’s feature availability page lists the languages Live Text supports, and some are limited to certain regions. Apple’s Ventura announcement also mentions Japanese and Korean. Text in a language on neither list is unlikely to be searchable.
- Region. Apple notes that Live Text isn’t available in all regions or languages.
- Legibility. Very small, blurry or heavily styled type may not be recognised. Apple doesn’t publish how well it copes, so I can’t give you a size or a threshold.
- Timing. Apple doesn’t document how long recognition takes for a new image. A screenshot taken a minute ago may match by file name or date but not yet by its words.
A useful test is to open the screenshot in Preview and try to select a word with the pointer. If you can select it, the text is recognisable. If you can’t, searching for it in Spotlight is unlikely to work either. The guide to copying text from a screenshot on a Mac walks through that.
How do you check one file?
When one specific screenshot won’t appear, look at the file itself. mdls prints the metadata Spotlight holds for a file, and it only reads.
Terminal
mdls -name kMDItemIsScreenCapture -name kMDItemContentCreationDate ~/Pictures/Screenshots/example.png
The path above is made up, so swap in your own file. For a screenshot macOS took, the output looks like this:
kMDItemContentCreationDate = 2026-09-30 14:03:11 +0000
kMDItemIsScreenCapture = 1
That example output is illustrative, not copied from a particular file. Here is how to read it:
kMDItemIsScreenCapture = 1means macOS marked the file as a screen capture. The attribute is not in Apple’s published reference, but macOS lists it among the attributes it reports.kMDItemContentCreationDateis when the file was created. The time is shown in UTC (note the+0000), so it can differ from the clock on your Mac by your time zone.(null)for either one means Spotlight has no value for it. I tried it on an ordinary system file and got(null)for the screenshot flag, as you would expect. If you get(null)on a screenshot you know macOS took, the file probably isn’t indexed yet, the folder is excluded, or indexing is off.- No output or an error usually means the path is wrong, so check the spelling and put a backslash before spaces or quote the path.
A screenshot saved by another capture app, or exported from somewhere else, may not carry the flag at all, even though it is a perfectly good image. That is why it can be missing from a search for screenshots specifically. If you want to count the files Spotlight does know about, there’s a related read-only command in the pillar guide, and a way to search by date in the guide to finding an old screenshot on a Mac.
What is the fix order?
Put together, the order that wastes the least of your time is:
- Search Privacy. Make sure neither the screenshot folder nor a parent is in the list.
mdutil -s /. Confirm indexing is enabled.- Wait. Let the Mac sit idle and plugged in if it has just updated.
mdlson the file. See whether macOS recorded it as a screenshot and when.- Re-add the folder. Put it in Search Privacy for a few seconds, then take it out.
sudo mdutil -E /. Rebuild the index, only if everything above was clean.
When should you stop fighting Spotlight?
Sometimes Spotlight is working exactly as designed and the screenshot still can’t be found. It indexes the whole Mac, reads only some languages, and has no idea which app a screenshot came from. If you’re searching for “the pricing page I captured in Figma” and the word Figma isn’t in the image, no amount of reindexing will help.
If you only look for a screenshot now and then, the fixes above are enough, and nothing needs installing. If you take screenshots instead of notes and search for them often, a search made for them is a better fit than a search made for everything. DejaShot is that: a Mac app that reads the text in every screenshot in the folders you choose and, for screenshots taken while it’s running, notes which app was in front. That is a hint, not a record, so it can occasionally be wrong. A search across 20,000 screenshots takes 31 ms. At the 95th percentile, on an M2 Pro, measured in the search engine itself. It needs macOS 14 or later, and it runs alongside Spotlight rather than replacing it.
For a straight side-by-side, see Spotlight and Live Text compared with DejaShot. For the full set of built-in methods, start with how to search the text in screenshots on a Mac.