What is textunderstandingd on my Mac?
Last reviewed: 19 November 2026. Path, account, launchd job and man page checked on macOS 26.3.1.
textunderstandingd is the macOS daemon that powers Text Understanding functionality for processing documents. Its launchd job connects it to Spotlight's content stream and names services for smart replies and document understanding. It runs on demand and exits when idle.
textunderstandingd at a glance
| textunderstandingd | |
|---|---|
| Made by | Apple (part of macOS) |
| Type | Per-user agent |
| Location | /usr/libexec/textunderstandingd |
| Runs as | your user |
| Started by | launchd job com.apple.textunderstandingd |
| Can you quit it? | You can, but launchd starts it again when documents need processing. |
What is textunderstandingd?
The textunderstandingd(8) man page says it powers Text Understanding functionalities for processing documents. It runs as your user from the com.apple.textunderstandingd launch agent.
Its launchd job registers services with names such as com.apple.TextUnderstanding.SmartReplies.Inference, com.apple.TextUnderstanding.DocumentUnderstandingHarvesting and com.apple.TextUnderstanding.DocumentUpdateHandler, and receivers for Core Spotlight, the framework apps use to give their content to Spotlight. It is also woken when suggestion settings change. The launchd job of suggestd listens for notifications named for Text Understanding pipeline results.
Is textunderstandingd safe?
Yes. textunderstandingd is part of macOS at /usr/libexec/textunderstandingd and runs as your user.
Why does textunderstandingd use so much CPU?
- New content from apps. Its Core Spotlight receivers mean content that apps give to Spotlight can be passed to it for processing.
- Smart reply suggestions. One of its services is named for smart replies inference, used when replies are suggested.
- Suggestion settings changing. Its launchd job listens for the suggestions settings changed notification.
How much CPU is normal for textunderstandingd?
Typical: not running, or short bursts when new content arrives in bulk, such as after a large mail sync.
Continuous activity for hours is not typical.
What can you do if textunderstandingd keeps using CPU?
- Let large syncs finish. After adding a mail account or syncing many documents, give it time on power.
- Limit learning per app. In System Settings > Apple Intelligence & Siri, Siri Suggestions & Privacy lets you switch off learning from specific apps.
- Ask launchd why it is running.
launchctl blame gui/$(id -u)/com.apple.textunderstandingdprints what started it.
When should you worry about textunderstandingd?
Worry if it runs at high CPU for long periods without new content, or crashes repeatedly in Console.
A textunderstandingd outside /usr/libexec would not be Apple's.
How do you check textunderstandingd in Activity Monitor and Terminal?
Open Activity Monitor (Applications > Utilities), and type textunderstandingd in the search field. The CPU tab shows its % CPU. Double-click the row for its parent process, memory details and open files.
In Terminal, the first command lists every textunderstandingd process with its PID, user, CPU and memory (RSS is resident memory in kilobytes).
ps -axo pid,user,%cpu,%mem,rss,command | grep -F 'textunderstandingd' | grep -v grep
How can Thrum help with textunderstandingd?
Thrum keeps a live CPU graph in the menu bar. One click shows the eight processes using the most CPU, so you can see when textunderstandingd is among them and how much it takes. An optional alert tells you when a process stays above a CPU level you choose (50 to 200% of one core) for 1 to 10 minutes. Click textunderstandingd in the list for its PID, threads and memory, and Quit or Force Quit it after a confirmation.
Thrum is $4.99 once with a 14-day free trial and no account. It requires macOS 26 Tahoe on Apple silicon or Intel.
Questions about textunderstandingd
Does textunderstandingd read my documents?
Its man page says it processes documents for Text Understanding, and its launchd job receives content through Core Spotlight. Apple does not say more.
Is textunderstandingd part of Spotlight?
It is separate, but it receives content through Core Spotlight receivers in its launchd job.
Sources
- textunderstandingd(8) man page: run man textunderstandingd in Terminal
- launchd jobs com.apple.textunderstandingd and com.apple.suggestd: run plutil -p on their plists in /System/Library/LaunchAgents