One of the quietly great features of macOS is that Spotlight doesn’t just find files by name — it finds them by contents. Press ⌘Space, type a phrase from inside a contract you filed away two years ago, and the document surfaces instantly. Unless it’s a scan. Then Spotlight finds nothing, no matter how many times the phrase appears on the page. Here’s why, and how to fix it for your entire archive.
How Spotlight actually indexes PDFs
Spotlight maintains a continuously updated index of your files. For each PDF, a system importer extracts the file’s metadata and — crucially — its text content, and adds it all to the index. When you search, Spotlight consults the index rather than opening files, which is why results are instant even across hundreds of thousands of documents.
The key phrase is text content. A scanned PDF is a container of page images; there are no characters inside the file for the importer to extract. Spotlight indexes the filename and basic metadata, and that’s all it can do. The scan is invisible to content search — not because Spotlight is weak, but because the file is empty of text. (This is the same reason ⌘F fails inside scanned PDFs.)
A quick way to check any PDF
- Open the PDF and try to select a few words. If the cursor selects words, the file has real text; if it draws a box, it’s an image-only scan.
- Comfortable with Terminal? Run
mdimport -t -d2 yourfile.pdfreplacingyourfile.pdfwith the file’s path — it shows what the Spotlight importer can pull from the file. For a scan, the extracted text is essentially empty.
What doesn’t fix it
- Renaming files descriptively. Helps a little, scales terribly — you can’t put every searchable phrase in a filename.
- Live Text in Preview. It recognizes text on screen but writes nothing back into the file, so the Spotlight index never sees it.
- Reindexing Spotlight. Rebuilding the index (System Settings → Spotlight, or
mdutil -E) fixes a corrupted index. It cannot conjure text out of an image-only file.
What fixes it: an embedded text layer
The fix is OCR that writes its results into the PDF as an invisible text layer under the page image. Once the file contains real text, the Spotlight importer extracts it during its normal background indexing, usually within moments of the file being written. Nothing else about your workflow changes: same folders, same filenames (plus a suffix), same Finder.
Any tool that embeds a text layer works for this — Adobe Acrobat Pro, ABBYY FineReader, or a cloud service if the documents aren’t sensitive (they usually are; see the no-cloud guide). The catch for an archive is volume: opening and processing files one at a time through an app is fine for five documents and unbearable for five hundred.
The archive-scale way: right-click the folder
This is the workflow RightClickOCR was designed around — turning a whole folder of scans into a Spotlight-searchable corpus in one action:
- In Finder, right-click the folder that holds your scans (or a single PDF).
- Choose Make Searchable (OCR).
- Every PDF inside gets a sibling copy — “Name (Searchable).pdf” — with an invisible text layer. Originals are never modified.
- Spotlight’s background indexer picks up each new file automatically. Within moments, ⌘Space finds phrases inside them.
Recognition runs 100% on-device via Apple’s Vision framework — nothing is uploaded, which matters if the archive is client files, patient records, or anything else confidential. Crooked pages are deskewed automatically and handwriting is recognized too (accuracy varies with legibility and scan quality), which old scan archives tend to need. (First-time setup requires a one-time macOS toggle — walkthrough here.)
Tips for a Spotlight-friendly scan archive
- Keep the searchable copies in the same folders as the originals. The “(Searchable)” suffix makes pairs obvious, and both stay under the same project or client folder for scoped searches.
- Search within a folder when you know the neighborhood. Open the folder in Finder, use the search field, and choose the folder name instead of “This Mac” — content search, scoped.
- Use quoted phrases in Spotlight (“quarterly rent escalation”) to cut through noise in large archives.
- OCR at scan time going forward. New scan lands in the folder → right-click → searchable — a five-second habit that keeps the archive complete. For big backlogs, see batch OCR multiple PDFs.
If Spotlight still doesn’t find a phrase
- Open the searchable copy and check with ⌘F that the phrase really was recognized (OCR accuracy depends on scan quality).
- Confirm the folder isn’t excluded in System Settings → Spotlight → Search Privacy.
- Give the index a minute on very large batches — thousands of new files take a little time to ingest.
- As a last resort, reindex the volume with
sudo mdutil -E /in Terminal.
Once the text layer is in the file, Spotlight does what it has always done for your other documents — it just finally has something to read.
It’s worth pausing on what that unlocks. Spotlight search isn’t just the ⌘Space bar — it also powers Finder’s search field, smart folders, and the content search other apps build on macOS’s index. A scan archive with real text layers participates in all of it: a smart folder that gathers every document mentioning a project name, a Finder search that narrows a decade of client files to the four that matter. One batch OCR pass, and an archive stops being storage and starts being a database.