HoudahSpot Troubleshooting: Files Missing from Search Results

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.

Before reaching for a rebuild, work through the steps below in order. Most missing-file problems are resolved at step 1 or 2.

Step 1: Check Spotlight Privacy settings

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

System Settings → System Settings… → Spotlight → Search Privacy

Make sure the folder or volume you're searching is not listed here. If it is, remove it from the exclusion list and allow Spotlight to index that location.

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 by Spotlight.

System Settings → Privacy & Security → Full Disk Access

Ensure HoudahSpot is enabled in the list. If it's not listed, click the + button and add HoudahSpot from your Applications folder.

Step 3: Reset HoudahSpot to factory defaults

A misconfigured search template can cause unexpected results — for example, searches that implicitly exclude certain file types or locations you wouldn't expect.

HoudahSpot → Settings → General → Factory Default

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.

Rebuild instructions: Apple Support KB 102321

---

For external drives: verify indexing is enabled

If you're searching an external or secondary volume, confirm that Spotlight is indexing it. An external drive can be connected and readable without Spotlight indexing it.

1. Open /Applications/Terminal.app
2. Enter the following command and press Return:

   mdutil -sa

3. 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.

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

sudo mdutil -i on "/Volumes/YourVolumeName"

---

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 or mdutil output.

Check for hidden indexing markers

1. Open /Applications/Terminal.app
2. Type the following (include the trailing space):

   ls -al 

3. Add the path of the volume you want to check. 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 handles special characters automatically:

   ls -al /Volumes/My\ External\ Drive

4. Press Return. The -a flag shows 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. Hidden files appear semi-transparent.

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

---

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.

1. Log in with an account that has administrator privileges.
2. Go to System Settings → Privacy & Security → Full Disk Access and enable it for /Applications/Terminal.app.
3. Open /Applications/Terminal.app.
4. 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.

5. When prompted for your password, type it and press Return. No characters will appear as you type — this is expected.
6. Paste the following command and press Return:

   sudo mdutil -X "/"

   This erases all Spotlight settings for the startup disk.

7. Paste the following command and press Return:

   sudo mdutil -i on "/"

   This turns indexing back on.

8. Go back to System Settings → Privacy & Security → Full Disk Access and revoke access for Terminal.app.
9. 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.

You can also check why Spotlight sometimes fails to find files — some of those causes apply to HoudahSpot results as well since both use the same index.