Spotlight problems

Keeping folders out of the index

Updated 2026-07-31 · 4 min read

Sometimes the fix is less indexing, not more. Excluding the churn is legitimate maintenance.

The supported way

System Settings → Siri & Spotlight → Spotlight Privacy → drag folders or volumes in. Effect is immediate; the index for those paths is dropped.

Good candidates: VM disk folders, build output trees, scratch/cache directories, cloned repos you never search, backup staging areas.

From the Terminal, per volume

Indexing can be disabled per volume:

sudo mdutil -i off /Volumes/Scratch

And an external volume can carry a marker file that tells every Mac it meets not to index it:

sudo touch /Volumes/Scratch/.metadata_never_index

On modern macOS this flag file is respected for external volumes (it was historically honoured more broadly). It travels with the drive — useful for scratch disks and camera cards that should never cost an indexing pass on any machine they touch.

What exclusion changes

• Those files stop appearing in Spotlight and Finder search
• mdfind cannot see them either — same index
• The churn stops: no mdworker activity for that tree
• find and any independent index still see everything; exclusion is Spotlight-only

What it does not fix

Excluding a folder does not reclaim much disk (the index is compact) and does not speed searches dramatically unless the excluded tree was pathological. Its real value is stopping perpetual re-indexing of files that change constantly.

Check what is currently excluded

The Privacy pane is the truth for folders. For volumes:

mdutil -s -a

lists every volume's indexing state at once.

Common questions

What is .metadata_never_index?

A marker file at a volume's root telling macOS not to index it — respected for external volumes and portable between Macs.

Does excluding folders from Spotlight speed up my Mac?

It stops re-indexing churn for busy folders, which helps when those folders change constantly. It is not a general speed-up.