Spotlight indexing on a Mac, from Apple's definition to the process in Activity Monitor
Apple's own account of the Spotlight index and of mds_stores, what a normal reindex looks like at each stage, and the one rebuild Apple still recommends.
By Chethan Kumar S N · Updated
mds_stores is one of the few processes a Mac user meets by choice. It appears at the top of Activity Monitor’s CPU list during a busy moment, the name has no words in it, and the machine is suddenly warm. So people search for it, find years of forum posts telling them to delete something called a Spotlight index, and then hesitate, correctly, because deleting things in system folders is how a working Mac becomes a weekend project.
There is a shorter route to the answer. Apple has an article about this exact subject, published in August 2026, that nobody seems to quote: About Spotlight indexing and search results on Apple devices. It explains what the index is, when indexing runs, how long it can take, and the one repair Apple still recommends for a stuck index. Everything below either comes from that article, from Apple’s macOS 27 User Guide, from the manual pages on this Mac, or from measurements taken on it while writing this page.
Apple’s definition of the index, in one paragraph
The article opens by defining the thing people are actually curious about:
Spotlight is Apple’s system-wide search feature, and it relies on a regularly updated search index of the data stored on your device. This is a local, private index that stays on your device and isn’t shared with Apple or your other devices.
Then it lists what the index covers, which is broader than most people assume:
Spotlight uses this index to help you find files, folders and apps, including a wide range of content such as documents, email, text messages, contacts, photos, music, podcasts, notes, system settings and much more. Siri can also use content from the index when responding to your requests.
Two facts fall out of that pair of sentences. The index is a database about your data, not a copy of your data, and it lives on the Mac rather than in an account. And it is used by more than the search window: Finder search, the Open dialog inside apps, Siri answers and, since macOS 27, the conversation that starts when you press Command-Space bar all read from the same place. A search box that finds nothing is usually a search box on top of an index that is not finished.
The processes, and which one is doing the work
The family is larger than the one name that shows up in Activity Monitor. This is what was running on the Mac this page was written on, an M1 Pro with 32 GB of memory on macOS 27.0.1, sampled with a plain process listing.
| Process | What it is | Seen on this Mac |
|---|---|---|
mds | The metadata server. Apple’s manual page is blunt about it: mds is the metadata server, it serves all clients of the metadata APIs including Spotlight, and there are no configurations to it. It runs as root. | Running since 4 November, about 22 MB resident |
mds_stores | The process that owns the stores themselves, so it is the one doing the reading, writing and answering. It runs under the _mds_stores account, and its parent is launchd. | Running since 4 November, about 20 MB resident, and about 96 minutes of processor time in those nine and a half days |
mdworker_shared | Importers. Each one opens a file, reads its metadata and hands the result to the store. They are spawned per job, so the count moves: four were live at one sample on this machine, eight at an earlier one. The mdworker page watches one spawn four seconds after a file lands, and counts 82 of them passing through a single hour. | Several at a time, each appearing and disappearing |
mdbulkimport | The bulk version of the same job, used when a large set of files arrives at once, which is the migration and external drive case. | Running since 20 October |
mdwrite | The small helper that writes metadata back. | Running since 4 November, under 1 MB resident |
corespotlightd | The index for content that apps provide themselves rather than read from disk, such as mail, notes and messages. | Running since 20 October, about 31 MB resident |
spotlightknowledged | The knowledge side, which is the part that has grown alongside Apple Intelligence. | Running since 21 October |
Every name in that list belongs to a feature rather than to a fault, and the same is true of the other processes people search for by name. kernel_task is the system slowing the CPU down when it is hot, WindowServer draws what is on screen, bird is the iCloud Drive sync engine, which has a page of its own, photoanalysisd is the one that reads your photo library, which has one too, and mediaanalysisd is the one that reads your photos and videos, which also has a page.
The importers are the part worth understanding, because they explain why indexing is slow in a way that has nothing to do with Spotlight being badly written. Each file type is handled by a plug-in, and you can list them:
$ mdimport -L
Paths: id(501) (
"/System/Library/Spotlight/iWork.mdimporter",
"/System/Library/Spotlight/iPhoto.mdimporter",
"/System/Library/Spotlight/PDF.mdimporter",
"/System/Library/Spotlight/RichText.mdimporter",
"/System/Library/Spotlight/Office.mdimporter",
...
)
Eighteen of Apple’s own importers were active for this account, covering iWork documents, PDFs, rich text, Office files, PostScript, MIDI, archives, audio, images, fonts, Mail messages, contacts and calendars, and the folder they live in holds more than fifty of them in total. Apps add their own: the list on this Mac also carries an importer from Microsoft Outlook and one from Xcode. So indexing a drive means opening thousands of files with a few dozen different readers, which is why it reads as heavy work rather than a background chore. The third party ones are registered as background items as well as plug-ins: the Outlook importer appeared in this Mac’s background task log as an item of type spotlight, and the background items page covers where entries like it show up. Contacts have their own arrangement: the contactsd page shows the daemon that owns the contacts database running a nightly job called VerifyCoreSpotlightService, on power and screen asleep, to check its slice of the index is honest.
The job that starts all of this is a launch daemon, and its configuration file is readable, which makes the schedule less mysterious:
$ plutil -p /System/Library/LaunchDaemons/com.apple.metadata.mds.plist
"Label" => "com.apple.metadata.mds"
"RunAtLoad" => true
"KeepAlive" => true
"MachServices" => {
"com.apple.metadata.mds" => true
"com.apple.metadata.mds.cachedelete" => true
"com.apple.metadata.mds.legacy" => true
"com.apple.metadata.mds.xpcs" => true
}
"LaunchEvents" => {
"com.apple.mds.abandonedIndexDeletion" => { "Interval" => 518400 }
"com.apple.mds.repeatingHealthCheck" => { "Interval" => 518400 }
}
518400 seconds is six days, so the server also wakes itself for a health check and to clear abandoned indexes on that rhythm, whether or not you have changed a single file. That, and not a fault, is why a completely idle Mac occasionally shows a flicker of mds activity.
When indexing runs, in Apple’s words
This is the part that answers most of the searches, so it is worth quoting rather than paraphrasing:
Indexing happens when you first set up your device, after you install a software update or upgrade, and as data changes on your device. For example, the index will update when you install new apps that allow their content to be indexed, or you receive new email or text messages.
And the honest range for how long it takes:
Depending on the amount of data on your device, Spotlight indexing can take hours or even days. Incremental updates after that are much faster.
Apple then lists the three conditions that make it finish sooner, which are worth treating as instructions: the device not being in use, the device connected to a power source, and the device connected to the internet over Wi-Fi or Ethernet in case email or other data needs to be downloaded for indexing. Read those three together and the pattern behind years of “why is my new Mac slow” posts is obvious. A brand new Mac on battery, with someone using it, is the slowest possible way to build an index, and it is also one of the honest reasons a battery looks like it is draining faster than it should: the update is doing real work, and it stops.
Apple also names this work in a place people do not expect it. The support article about fan noise, in its list of ordinary jobs that make a fan audible, includes “indexing the hard drive with Spotlight after you’ve migrated data”, sitting next to compressing HD video and playing a graphics-heavy game. The same machine that is quiet when it is finished is loud while it is catching up, and Apple lists that as expected. Why a Mac’s fan is so loud takes the heat side of that further.
Migration is the case worth calling out separately, because it is where the numbers get big. A restore or a migration assistant transfer lands hundreds of thousands of files at once, every one of them new to the index, which is why the first day after moving to a new Mac feels like the machine is doing something secret.
Reading the status, without guessing
Apple documents two visible signals. The first is the one people notice and misread: on a Mac you see an indexing progress indicator at the top of the Spotlight or Siri window that opens when you press Command-Space bar. The second is a notification from Mail that indexing is incomplete, which is Apple’s way of explaining that incomplete search results in Mail are a symptom of the index rather than of the mail.
The terminal version is more precise, and it is a read, not a change:
$ mdutil -s /
/:
Indexing enabled.
mdutil manages the metadata stores, and its own manual page carries the one caveat that explains odd cases better than any forum answer: indexing may be delayed due to low disk space or other conditions. That single line covers the Mac that has been rebuilding for three days, because on a nearly full disk the index is the work that gets deferred. It is also the honest link between this page and the System Data row in the Storage pane, and if the disk rather than the index is the thing you need to understand, the storage page that starts from a full disk with nothing on it is the other half.
There is a status for every mounted volume too, and it is worth seeing once so that the output does not alarm you later. On this Mac it lists the internal volumes as enabled and six mounted volumes, mostly disk images, as disabled:
$ mdutil -as
/:
Indexing enabled.
/System/Volumes/Data:
Indexing enabled.
/System/Volumes/Preboot:
Indexing enabled.
/Volumes/Ardia:
Indexing disabled.
/Volumes/Crest:
Indexing disabled.
Disabled is not a fault. A mounted installer image or a scratch volume does not need to be searchable, and Spotlight skips volumes that are excluded from search, which is what those entries are.
And a live sample from the system log shows what a working store process looks like from the inside, which is reassuringly dull. These lines came out of a two minute window on the Mac this page was written on:
mds_stores: (SpotlightIndex) [com.apple.spotlightindex:Query] client bundle: (null), query nodes count 1
mds_stores: (SpotlightIndex) [com.apple.spotlightindex:SDB] Write cache 0x78e6878000: slot 27 page 0x71f8b24000 armed for mprotect guard
Queries answered, caches written. If you want to see the index proving itself rather than describing itself, ask it something and count the answers:
$ mdfind "kMDItemContentType == 'public.plain-text'" | wc -l
5651
Five thousand six hundred and fifty one text files, found without touching the disk. That is what the index is for.
The one rebuild Apple recommends
If search is genuinely stuck for particular files, Apple’s repair is small and specific, and it is not “delete the index folder”. Apple’s article describes it as rebuilding part of the Spotlight index, and the steps are:
- From the Apple menu, choose System Settings, then click Spotlight (or Siri & Spotlight) in the sidebar.
- Scroll down on the right and click the Search Privacy (or Spotlight Privacy) button at the bottom of the window.
- Drag the disk, such as Macintosh HD, or the folder you want to reindex into the list of locations that Spotlight is prevented from searching, or click add and choose it.
- Wait a few seconds, then select it in the same list and click remove to take it back out.
- Click Done and quit System Settings. Spotlight now reindexes the contents of that disk or folder.
The wait between adding and removing is the whole trick, and Apple is explicit about the caveat: if you get an unknown error or an error related to permissions, your user account may not have ownership permissions for some of the items in that disk or folder. That is a permissions question rather than a Spotlight question.
One caution about the same list, in Apple’s own words from the settings pane itself. When you add a location, the warning reads: if you exclude this location from Spotlight searches, the search feature won’t work in some applications. So the list is a live switch rather than a queue. A folder sitting in it is a folder apps cannot search, which is why the add-then-remove sequence matters.
Turning indexing off, and what you are really switching off
mdutil will do this per volume. The manual page describes indexing off as setting the indexing status for the provided volumes, with the same low disk space caveat attached. The erasing option is the heavier one: mdutil -E causes each local store for the volumes indicated to be erased, and the stores will be rebuilt if appropriate. The option with the best name and the most misleading one is -X, which removes the Spotlight index directory on the specified volume and then says plainly that this does not disable indexing, because Spotlight will reevaluate the volume the next time it is unmounted and remounted, the Mac is rebooted, or an explicit index command is run.
That last sentence is worth keeping. It is the reason the folk remedy of deleting the hidden index folder does not stick, and the reason a proper rebuild goes through either mdutil -E or Apple’s add-and-remove sequence in Settings.
The reason to think twice before switching indexing off is that you do not only lose the search window. Apple’s index is the one Finder search and app Open dialogs read, so a volume with indexing off becomes a volume you navigate by memory. On an old Mac with a slow spinning disk, that trade can be worth it for a scratch volume and rarely worth it for the startup disk.
One exception is handled for you, and it is documented: if you add a Time Machine backup disk, the settings pane explains that Spotlight will continue to search Time Machine backups but will not search other items on the disk. Backups stay findable even when you think you have excluded them.
What the index costs in disk, and what nobody can measure
The index is a folder rather than a file, and on a modern Mac it sits on the data volume:
$ ls -ld /System/Volumes/Data/.Spotlight-V100
drwx--x--- 4 root _mds_stores 128 Sep 19 19:38 /System/Volumes/Data/.Spotlight-V100
Note three things. It is owned by root and the _mds_stores group, the permissions are 710 so a normal account cannot even list it, and the date on this Mac is the day it was set up. Try to measure it and macOS says no:
$ du -sh /System/Volumes/Data/.Spotlight-V100
du: /System/Volumes/Data/.Spotlight-V100: Operation not permitted
That is the honest answer to “how big is the Spotlight index”, and it is why every confident number you find online is somebody’s guess or an old version of macOS. What can be said without guessing is the shape of it: the index is a metadata database, it is proportional to the number of items rather than to their size, and a reindex temporarily reads the whole drive. That is disk work, and disk work competes with everything else, which is the practical reason to leave the Mac plugged in and alone.
Spotlight’s hidden folder has a twin one directory over. The file system events machinery keeps its own state in /System/Volumes/Data/.fseventsd, same root ownership, same permission denied for anyone trying to list it, and the same folder is what you find on USB sticks that a Mac has written to. The fseventsd page measures that daemon, its 89,000 log lines a day, and runs a live test to find out when the USB folder actually appears.
macOS 27 puts more weight on the index
The current Spotlight is a bigger surface than the one people remember from a few years ago, and Apple’s macOS 27 User Guide describes the shift in its opening line: when you turn on Siri AI, which is in beta in macOS 27, Spotlight becomes the place where you start a conversation with Siri, asking for personal context or taking actions across your apps from the same place you search.
Two settings rows in the Spotlight pane show what else the index now carries. Results from Clipboard is a switch that lets the contents of your clipboard appear in search results, with the retention set by a row that offers 30 minutes, 8 hours or 7 days, plus a Clear Clipboard History button. And Show Related Content allows content from Apple partners to be shown when searching or when looking up text, objects or photos. Both change what search returns rather than how indexing works.
One distinction is worth making carefully, because it is where privacy arguments go wrong. The index itself is local: Apple’s article says it stays on your device and is not shared with Apple or your other devices. The Help Apple Improve Search option is about something else entirely, the queries rather than the contents. Apple’s own wording in the settings pane is that the information collected is stored in a way that does not identify you and is used to improve search results, and the note in the guide adds that if you do not want your Look Up search queries data sent to Apple, you deselect that option. Turning it off does not affect the index, and emptying the index does not affect that setting.
Where window managers fit
Nothing on this page is something a window manager can help with, and it would be strange to pretend otherwise. The index is processor and disk work being done by processes that have nothing to do with how windows are arranged, and the honest advice while it runs is the advice Apple gives: let the Mac be idle, keep it plugged in, and give it a network. Every minute you spend arranging windows during a rebuild is a minute the rebuild does not get.
What does help afterwards is needing fewer moves. Ribbon keeps the windows you are using as a scrolling strip rather than a stack of overlapping rectangles, so a search that feels slow on a busy Mac is not followed by five minutes of resizing. It is $15, once, for up to 3 Macs, with a full refund within 10 days, and it runs on macOS 14 Sonoma and later on Apple silicon and Intel Macs. You can drive the strip in your browser before you install anything, and if the Mac is slow rather than busy, the three numbers worth checking first is the better place to start.
The short version
Spotlight indexing is the process of keeping a local database about your files up to date so that search can answer instantly. The guesses that appear before you finish typing, in Spotlight, Siri and the QuickType keyboard, are a different daemon’s work: suggestd builds that layer on top of the index, and its page measures the sixteen scheduled jobs behind it. Apple’s own article says the index is local, that it is built at setup, after updates and as data changes, and that it can take hours or even days on a machine with a lot on it. While it runs you may see an indexing indicator at the top of the search window and a Mail notification about incomplete indexing, both of which are progress rather than failure. Apple’s listed conditions for finishing sooner are an idle Mac, mains power and a network connection. The only repair Apple recommends for a stubborn index is adding a disk or folder to the Search Privacy list and then removing it, which schedules a reindex of that location. mds_stores and its relatives are part of macOS, they cannot measure tidily from a normal account, and the one thing nobody should do is delete the index folder by hand, because the manual page says plainly that it will come back.
Questions
What is Spotlight indexing on a Mac?
It is the job of building and maintaining the local database that Spotlight searches. Apple describes it this way: Spotlight is Apple's system-wide search feature, and it relies on a regularly updated search index of the data stored on your device, a local private index that stays on your device and is not shared with Apple or your other devices. Apple's list of what goes into it is long, and it is the reason a search for a word you typed in a note two years ago works at all: files, folders and apps, plus documents, email, text messages, contacts, photos, music, podcasts, notes and system settings. Siri can use the same index when it answers you, and on macOS 27 that overlap is bigger than it used to be.
Is mds_stores a virus or malware?
No, and you can check it rather than take anyone's word for it. It is part of the Metadata framework inside /System/Library/Frameworks/CoreServices.framework, and it runs under a user account called _mds_stores that exists for exactly this purpose. The mds man page describes the family in one line: mds is the metadata server, it serves all clients of the metadata APIs including Spotlight, and users should not run it manually. Anything running from that path is Apple's own code, protected by the sealed system volume.
How long does Spotlight indexing take?
Apple gives the honest range: depending on the amount of data on your device, Spotlight indexing can take hours or even days, and incremental updates after that are much faster. Apple also lists the three things that make it finish sooner, which are worth arranging: the device not being in use, being connected to a power source, and being connected to the internet over Wi-Fi or Ethernet in case email or other data needs to be downloaded first. A fresh install or a migration is the slow case. A Mac that reindexes a folder takes minutes.
How do I know when Spotlight has finished indexing?
Apple documents the indicator: on a Mac you see an indexing progress indicator at the top of the Spotlight or Siri window that opens when you press Command-Space bar, and you may also get a notification from Mail that indexing is incomplete. When the indicator is gone, the index has caught up. In the terminal, mdutil -s / prints the state directly, and it says Indexing enabled when all is well. If you want a second opinion, Activity Monitor's CPU tab shows what the processes are doing: importers appearing and disappearing is progress, however slow it looks, while a machine with a stuck index is one where the indicator stays up and the numbers never move.
Can I turn Spotlight indexing off on my Mac?
Yes, and it is worth knowing what you are switching off. The mdutil command takes an on or off value per volume, so mdutil -i off on a volume stops the index being maintained for it. Adding a folder or disk to the Search Privacy list in Spotlight settings does the same thing for that location, and Apple's own warning appears when you do it: if you exclude this location from Spotlight searches, the search feature won't work in some applications. The cost is that the content stops showing up in Spotlight, in Finder search, and in the Open dialogs of apps that use the same index. The saving is some processor time and disk activity, which is a real trade on an old machine and a pointless one on a fast one.
Ready? Buy Ribbon for $15, or read all the guides.