HoudahSpot Not Finding Files on Mac? Fix Missing and Disappearing Results

If HoudahSpot fails to find a file that you know exists on your Mac, the cause is almost always a problem with the Spotlight index.

Because HoudahSpot relies on Spotlight, missing or corrupted index entries can cause files to disappear from results.

This guide walks you through the most common causes and how to fix them.

Why files sometimes disappear from results

When you preview or open a file, macOS may schedule it for re-indexing. HoudahSpot is designed to handle the transition smoothly — keeping the file visible in results while the index updates. But there are two edge cases:

Under heavy system load, you may see a file briefly vanish and then reappear. This is normal.
With a corrupted index, the file may vanish without reappearing. This requires an index rebuild.

Step 1: Check Spotlight Privacy settings

Files in excluded locations will not be indexed — and therefore won’t appear in HoudahSpot.

System Settings… → Spotlight → Spotlight Privacy

(on older versions of macOS: Siri & Spotlight → Search Privacy)

Make sure the folder or volume you’re searching is not listed here.

Step 2: Grant Full Disk Access to HoudahSpot

Without Full Disk Access, HoudahSpot may be unable to surface results from certain protected locations — even if those locations are indexed.

System Settings… → Privacy & Security → Full Disk Access

Ensure HoudahSpot is enabled in the list.

Step 3: Reset HoudahSpot to factory defaults

A misconfigured search template can cause unexpected results.

HoudahSpot → Settings… → General → Factory Default

This resets the default search template used when you create a new search.

Note: This option only appears if you have previously overridden the factory default. If available, select it and try your search again.

Step 4: Rebuild the Spotlight index

If the steps above don’t help, the Spotlight index itself may be corrupted.

When the Spotlight index is damaged, files may disappear permanently from search results. Rebuilding the index forces macOS to recreate it from scratch.

Rebuild instructions: https://support.apple.com/en-us/102321

⚠️ Rebuild the index for the entire affected volume — not just one affected folder. A partial rebuild does not always fix corruption.

Important: Re-indexing requires Spotlight to read and process all your files. macOS throttles this to avoid interfering with your work. A full re-index typically takes hours to days. Leave your Mac running overnight so it can work undisturbed.

For external drives: verify indexing is enabled

If you’re searching an external or secondary volume, confirm that Spotlight is indexing it.

Log in with an account that has administrator privileges.
Open /Applications/Terminal.app
Enter the following command and press Return:
```
mdutil -sa
```
Look for your volume in the output. It should say Indexing enabled.

Example output:

/:
    Indexing enabled.
/System/Volumes/Data:
    Indexing enabled.
/Volumes/My External Drive:
    Indexing enabled.

Note: On modern macOS systems using APFS, you may see both / and /System/Volumes/Data listed. These represent different parts of the same startup disk. It is normal for both to show Indexing enabled.

If indexing is disabled for a volume, enable it with:

sudo mdutil -i on "/Volumes/YourVolumeName"

When prompted, enter your password (hidden from view) and press Return.

Hidden files that prevent indexing

Beyond System Settings and mdutil, certain hidden marker files can silently block Spotlight from indexing a folder or volume. These files have names beginning with .metadata, for example:

.metadata_never_index
.metadata_never_index_unless_rootfs

If one of these files exists at the root of a folder or volume, Spotlight will not index that location — regardless of your privacy settings.

These files are often created by beta versions of macOS, backup tools or system utilities to intentionally disable Spotlight indexing.

Check for hidden indexing markers

Open /Applications/Terminal.app
Type the following (include the trailing space, but not the quotes):
```
ls -al 
```
Now add the path of the volume you want to check. You have two options:Option A — Type the path in double quotes:
```
ls -al "/"
```
or
```
ls -al "/Volumes/My External Drive"
```
Option B — Drag the volume icon from Finder into the Terminal window (after the space). Finder will automatically handle special characters in the path. Do not add quotes when dragging:
```
ls -al /Volumes/My\ External\ Drive
```
Press Return. The ls command lists files in the directory. The -l option shows details in long format; the -a option includes hidden files (those beginning with a period).

Look for any files matching .metadata* in the output.

Remove the marker file

If you find a .metadata_never_index file, the easiest way to remove it is from Finder.

To show hidden files in Finder, press ⌘ + ⇧ + . (Command + Shift + Period). This toggles hidden file visibility on and off. Hidden files appear semi-transparent.

Locate and delete the .metadata file, then allow Spotlight to re-index the location.

Note: Some Terminal commands may require Full Disk Access for Terminal.app itself. You can grant this temporarily in System Settings → Privacy & Security → Full Disk Access. Once you are done, revoke it.

Deep rebuild: when everything else fails

If a standard index rebuild does not resolve the problem, a deeper reset will also clear any volume-specific Spotlight settings.

⚠️ This procedure requires administrator access and Full Disk Access for Terminal.

The following procedure resets both the Spotlight index and any stored indexing configuration for the disk.

Log in with an account that has administrator privileges.
Go to System Settings → Privacy & Security → Full Disk Access and enable it for /Applications/Terminal.app.
Open /Applications/Terminal.app.
Paste the following command and press Return:
```
sudo mdutil -E -i off "/"
```
This turns off Spotlight indexing for your startup disk and deletes the existing index.
You will be prompted for your password. Type it and press Return. No characters will appear as you type — this is expected.
Paste the following command and press Return:
```
sudo mdutil -X "/"
```
This erases all Spotlight settings for the startup disk.
Paste the following command and press Return:
```
sudo mdutil -i on "/"
```
This turns indexing back on.
Go back to System Settings… → Privacy & Security → Full Disk Access and revoke access for Terminal.app.
Allow your Mac several hours to complete indexing. Leave it running overnight for best results.

Still not working?

If none of the above resolves the issue, contact Houdah Software support with details about what you searched for, where the file is located, and which steps you have already tried.