Skip to content

Stop your Mac mangling names

7 min read

A knowledge worker types on a silver laptop at a wooden desk beside a blank name badge and a small index-card box while gray placeholder blocks fill the screen.

On Tuesday morning, Maya is sitting in a meeting room, finishing notes before everyone leaves, when her Mac turns a client’s correct surname into a common word. The acronym beside it loses its capitals. One line later, a specialist term acquires a space that nobody in the room would ever put there.

The fastest fix is to identify which language tool made the change, then give that tool the right instruction. Teach macOS a stable name or valid term. Create a text replacement when the output must always be exact. Let Typeahead turn terminology you use repeatedly into contextual completions that meet you at the cursor.

Those choices solve separate problems, even though we tend to call every interruption autocorrect. The clue is what appears on screen: a red underline, a changed word, gray text beside the cursor or a short trigger expanding into a longer phrase. Once you notice that signal, the settings stop feeling arbitrary and the correction becomes much easier to make.

Notice what the Mac changed

A red underline means macOS does not recognize the spelling in front of you. The word may still be correct. A surname, product name or specialist term can sit beneath that red line for months unless you teach the Mac to accept it or tell the current document to leave it alone.

An automatic substitution is more intrusive because the letters change after you type them. Autocorrection has treated your intended spelling as a mistake and supplied another word. If a correction has just happened, Change Back restores what you typed before the interruption pulls your attention away from the sentence.

Gray text at the cursor belongs to inline prediction. You can accept the offered word or phrase with Space, or keep typing and let it disappear. A short sequence that expands into a longer phrase is a text replacement. It follows a rule you created, so the same trigger produces the same wording each time.

I start with the visible signal because it tells me which control deserves attention. A dictionary entry will not repair a poorly chosen replacement, and disabling predictions will not teach the spell checker a surname. Giving each behavior its own job preserves useful assistance while stopping the specific change that keeps damaging your copy.

Teach the name you meant to write

For a correctly spelled name or specialist term, Control-click the word and choose Learn Spelling. The word joins the macOS dictionary used across documents and supported apps. That makes it the right home for a stable surname, an established product name or a technical term you expect to type well beyond the document open today.

If you teach the Mac a word by mistake, Control-click it and choose Unlearn Spelling. The removal matters when a typo has started passing without a warning. Apple’s guide to checking spelling and grammar shows both choices in the menu you see beside the selected word.

Ignore Spelling is narrower. It suppresses the warning in the current document without adding the term to your custom dictionary. I use it for a one-off identifier, a deliberate variant or a temporary project label that would be distracting today but should not follow me into unrelated writing next month.

Learn Spelling reaches further. The Pages spelling guide confirms that learned words can be available in other apps, and Apple notes that learned words are added for all languages. That reach rewards a little restraint around ambiguous abbreviations. A stable name belongs in the dictionary, while a temporary code often belongs only in its current document.

Save exact wording as a replacement

A dictionary entry establishes that a spelling is valid. It cannot expand a compact trigger into a full phrase or enforce an entire piece of approved wording. Text replacements handle that exact work. They suit a shortcut such as qbrd becoming Quarterly Business Review, or an initialism that must retain unusual capitalization every time it appears.

Open System Settings > Keyboard > Text Replacements, then enter the shortcut and the replacement exactly as you want to see it. The choice of trigger deserves care. I prefer a memorable sequence that I would not type inside an ordinary word, which keeps the expansion deliberate and leaves everyday sentences untouched.

Apple covers the settings path and per-app activation. Text replacement is not available in every app, so check the app’s controls when a familiar shortcut stays compact. That small check can spare us from changing a system-wide rule that is already working everywhere else.

Replacements can sync through iCloud across your Mac, iPhone and iPad. They can also be exported as a property-list file and imported on another Mac. A reviewed terminology set can therefore travel between colleagues, although sharing remains a manual handoff rather than a centrally managed team glossary. The payoff is exact capitalization, expansion and punctuation wherever that set is installed.

Keep correction and prediction in their lanes

Correct spelling automatically changes text that macOS identifies as misspelled. Show inline predictive text places a gray word or phrase beside the cursor for you to accept or pass over. The controls are separate, so you can stop unwanted corrections while keeping useful predictions visible, or hide predictions while retaining automatic spelling fixes.

The system-wide choices appear under System Settings > Keyboard > Text Input > Edit. When I am diagnosing a stubborn change, I check those controls individually and return to the same sentence. Repeating one concrete example makes it obvious whether the changed word came from correction or whether the gray suggestion merely appeared beside what I had typed.

A supported app can override the system autocorrection choice through Edit > Spelling and Grammar. An app without that menu may use its own spell checker. Text replacement support can also vary by app. These visible controls explain why the same name may behave properly in Pages yet change inside another writing field.

Language selection can shape the suggestions too. If several names look wrong while you move between languages, review the spelling languages in the same macOS text input area. We get a cleaner result by adjusting the language or app responsible for the change, while leaving the parts of the writing setup that already understand our vocabulary in place.

Let familiar language meet you at the cursor

A learned dictionary word is allowed, and a text replacement follows one fixed trigger. Typeahead 2.5.0 adds a more fluid experience at the cursor. After you use a difficult spelling repeatedly, that spelling begins appearing as a completion where it fits the sentence, ready for you to accept without interrupting the thought already taking shape.

I know Typeahead has settled into a project when the difficult surname arrives after the first few letters, beside the specialist term I usually pair with it. The cursor keeps moving and the spelling remains mine. That half-second feels small until I return to a Mac without the same familiar completions and notice every pause again.

You begin the sentence, and Typeahead completes it in your voice. The author remains in control of every sentence, which is why autocomplete belongs beside your writing rather than in place of it. Repeated terminology can bend naturally with the sentence instead of behaving like a fixed block pasted after a shortcut.

Writing never leaves the Mac. Typeahead processes writing locally. Network activity is limited to license activation, optional update checks and the one-time download of your AI model. It runs on Mac with macOS 14 or later and is available as a one-time purchase, no subscription required.

We can give each layer a clear responsibility. Stable names and valid single terms belong in the macOS dictionary. Approved expansions, exact capitalization and multiword terminology belong in text replacements. Repeated spellings and phrasing that depend on the surrounding sentence can become Typeahead completions as you continue writing.

For a team, keep the shared replacement file reviewed and versioned, then let each person’s learned dictionary and local completions reflect the names and terminology they actually use. Fixed style decisions stay consistent without turning every personal habit into a group rule. The next time a new surname enters the project, you will know where to put it and how it can follow your writing into the work ahead.

Typeahead

Typeahead is an AI autocomplete tool for Mac that works system-wide. We write about AI, productivity, and the craft of putting words together.

Keep reading.

The autocomplete you'll feel lost without.

Your next sentence is already waiting.