# What Is ~/Library/Spotlight on Mac?

> ~/Library/Spotlight holds Spotlight importer plug-ins installed for your account, not the search index. It's usually tiny, and leftover importers can go.

- Updated: 2026-10-10
- URL: https://fresh.ist/library/spotlight/

**TL;DR:** ~/Library/Spotlight is where Spotlight importer plug-ins (.mdimporter bundles) can be installed for your account. Importers teach Spotlight to read the contents of file types it doesn't know. The search index itself isn't stored here, so this folder is small, and removing a leftover importer only stops Spotlight from reading that file type's contents.

## Definition

- Full path: `~/Library/Spotlight`
- Scope: user (inside your home folder)
- Freshist checks this folder when uninstalling an app. When you uninstall an app, Freshist looks here for items that belong to it. Matches on the app's bundle ID can be pre-selected; name-only guesses are labeled “not sure” and never pre-selected. Removed items go to the Trash, so you can undo.

## Importers, not the index

Spotlight finds files by their names and by their contents. For the contents part, it needs code that understands each file format: an **importer**. macOS includes importers for PDFs, Office and iWork documents, images, audio and more. Apps that use their own document formats can add importers so Spotlight can search inside those files too.

Classic importers are bundles ending in `.mdimporter`. Most apps keep theirs inside the app at `Contents/Library/Spotlight`, so they go away when the app does. Some installers instead copy one into `~/Library/Spotlight` (for your account) or `/Library/Spotlight` (for every account). Newer apps can use **Core Spotlight import extensions**, which also ship inside the app.

What this folder does *not* contain is the search index. Spotlight keeps that at the top level of each indexed volume, in a hidden folder that macOS manages and protects. Deleting files in `~/Library/Spotlight` won't reset the index or recover the space it uses.

| Where | What it holds |
|---|---|
| `~/Library/Spotlight` | Importers installed for your account, plus a small cache |
| `/Library/Spotlight` | Importers installed for every account (admin needed) |
| Inside an app (`Contents/Library/Spotlight`) | That app's own importer |
| `/System/Library/Spotlight` | Apple's built-in importers |
| Hidden folder at each volume's root | The search index itself |

## Checking which importers are active

These commands only read:

```
ls -la ~/Library/Spotlight
du -sh ~/Library/Spotlight
mdimport -L
mdutil -s /
```

`mdimport -L` lists every importer Spotlight currently loads, with its full path. Anything outside `/System/Library/Spotlight` came from an app or installer. `mdutil -s /` reports whether indexing is enabled for the startup disk.

## Removing a leftover importer

1. Find the importer in `mdimport -L` output and confirm which app it belongs to. The bundle name usually says.
2. In Finder, choose **Go → Go to Folder…** and enter `~/Library/Spotlight`.
3. Move the `.mdimporter` to the Trash. Leave the `ExtensionsCache` folder alone.
4. Run `mdimport -L` again. If the importer is still listed, log out and back in.

Files of that type remain searchable by name. Spotlight just stops reading their contents.

## Fixing search instead of plug-ins

If the real problem is missing results or constant indexing, work with the index through Apple's controls instead of this folder. In **System Settings → Spotlight**, you can exclude folders from search. Adding your disk to the privacy list and then removing it makes macOS rebuild the index, as Apple describes in its Spotlight support articles. Expect high CPU use for a while afterward; our post on [Spotlight indexing and high CPU](/blog/spotlight-indexing-high-cpu-mac/) explains what's normal.

[Quick Look generators](/library/quicklook/) went through the same move from loose plug-ins to app extensions. When uninstalling an app that installed an importer here, also check its [Preferences](/library/preferences/) and [Application Support](/library/application-support/) folders.

## Sources

- [Find what you need with Spotlight on Mac](https://support.apple.com/guide/mac-help/search-with-spotlight-mchlp1008/mac) (Apple Support)
- [About Spotlight indexing and search results on Apple devices](https://support.apple.com/en-us/102321) (Apple Support)
- [CSImportExtension](https://developer.apple.com/documentation/corespotlight/csimportextension) (Apple Developer Documentation)
- `man mdimport` and `man mdutil` in Terminal

## Frequently asked questions

### Will deleting this folder rebuild my Spotlight index or free space?

No. The index lives in a hidden folder at the top of each indexed volume, managed by macOS. ~/Library/Spotlight only holds importers and a small cache, usually a few kilobytes.

### What is the ExtensionsCache folder inside it?

On recent macOS versions, Spotlight writes a small cache here describing the import extensions apps provide. macOS manages it and recreates it as needed, so there's no reason to edit it.

### Spotlight is using a lot of CPU. Is an importer to blame?

It can be, if a third-party importer handles a file type you have many of, but heavy indexing after an update or migration is more common. mdimport -L shows which importers are active.

---

Canonical page: https://fresh.ist/library/spotlight/
Official site: https://fresh.ist/ (fresh.ist only)
Generated: 2026-10-10