// troubleshooting guide · quicksilver
Quicksilver Not Finding Files
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 18, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · quicksilver/not-finding-files4 FIXES
// quick answer
Quicksilver only scans the Desktop 1 level deep and Documents 2 levels deep by default. Copy the Documents source into a custom source and raise its depth, but never to infinite.
Most likely fix: Raise the scan depth
How to fix it
// try these in order, the most common fix is first
FIX 1Raise the scan depth
- 01Open Settings > Catalog, select the Users set, then Documents
- 02Open the drawer, Attributes tab, click Create Copy
- 03Select the new source in the Custom set, open Source Options and set a higher depth
- 04Avoid infinite depth; it slows Quicksilver down
Did this fix it?FIX 2Add the folder to the catalog
- 01Settings > Catalog > + > File & Folder Scanner
- 02Choose the folder and depth, then Rescan
Did this fix it?FIX 3Reset the search mode
- 01After arrowing into an item, click the gear at the top of the results list
- 02Choose Filter Results
Did this fix it?FIX 4Add real folders instead of symlinks
- 01Add the target directory (e.g. ~/.nix-profile/bin) rather than the symlink pointing to it
Did this fix it?
SANDBOX · quicksilver RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on Quicksilver-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Files you know exist don't show up when you type their names, or search seems to only look inside the current folder.
Why it happens
- C-01Shallow default scan depth
- C-02Folder not in the catalog at all
- C-03Search mode changed by Cmd+Right/Cmd+Left
- C-04Symlinked folders aren't indexed through the link
// this guide also covers
- quicksilver not finding files
- quicksilver search documents
- quicksilver scan depth
- quicksilver index folder
Still not working?
If Quicksilver keeps failing, you're not alone. See every Quicksilver problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usOther Quicksilver errors
- Quicksilver "Interface Could Not Be Loaded. Switching to Bezel"
- Quicksilver Not Working After macOS Update (Tahoe, macOS 27)
- Quicksilver Keeps Crashing
- Quicksilver High CPU Usage and Spinning Wheel
- Quicksilver Keeps Asking for Permissions
- Quicksilver Not Finding Applications
- Quicksilver Hotkey Not Working
- Quicksilver Actions Not Working (Finder, Mail, AppleScript)