GUIDE · SPOTLIGHT TROUBLESHOOTING
First separate two problems: Spotlight cannot find a file whose name you know, or it cannot match a description of a file whose name you forgot. An index repair may help the first problem. For the second, begin with different search clues.
16 October 2026 · Shlexball guide
Open the folder where you expect the file. Confirm that the file is there and can be opened, then search for its exact name. Use this as a control while changing one setting at a time. If you cannot locate it manually, first check how to find a file when you forgot its name.
If you can find the file by name but not by a vague description, that alone does not establish an indexing fault. Try a distinctive word you know appears in the document. Our PDF guide also covers scans and password-protected documents.
In Finder, confirm that the search covers the intended folder or This Mac, then remove any Kind or date filters that exclude the test file. Apple documents these controls in its Finder search guide.
In System Settings, open Spotlight, or Siri & Spotlight on some macOS versions. Check the enabled result categories and the Search Privacy or Spotlight Privacy list. A folder excluded there is intentionally omitted from Spotlight searches. Only remove an exclusion if you want that folder searched.
Apple says indexing can take hours or days after setup, upgrades or large changes. Keep the Mac powered and allow it idle time. The Spotlight window may show an indexing progress indicator. See Apple’s explanation of indexing and unexpected results.
Apple’s documented repair is to add the affected folder to the Spotlight privacy exclusions, wait a few seconds, and remove it again. Close settings and allow reindexing to finish, then repeat your exact-name test. Start with the folder involved in the problem. If macOS reports a permission error, resolve that issue rather than repeatedly rebuilding.
Shlexball searches the folder you select and can use file names and supported document contents. The model runs on your Mac. This offers another route when you remember what a document is about; it does not repair Spotlight, restore deleted files, or remove file permissions.
The offline search demonstration shows a letter about heating and an insurance policy in a folder of made-up documents. The recording shows what happened in that example. For the documented differences between the tools, read our Spotlight review and Spotlight vs Shlexball.
Shlexball requires macOS 15 or later, Apple silicon and 16 GB of memory. Internet is required for the initial model download; cached searches run locally. It has no OCR for scanned pages without a text layer. The first 30 searches are free and need no account.