OplitoJoin the list

Workflow

Mac text replacement not working: why it fails and what to try

Mac text replacement not working is usually down to the app, not your setup, because Apple says text replacements are not available in all apps. Test where it works, fix what you can, and choose another route for the rest.

· 6 min read · Oplito

The short answer

macOS text replacement only works in apps that support it, and Apple says that is not all apps. Check the entry in System Settings > Keyboard > Text Replacements, then test it in Notes or TextEdit. If it works there but not in your app, the app is the limit. Fix the setup if it fails everywhere.

How text replacement is meant to work

Text replacement is a macOS feature that swaps a short piece of text for a longer one as you type. You type omw and it becomes On my way. You set the pairs up once in System Settings, and macOS applies them in apps that use its standard text system.

Apple's steps are short. Choose Apple menu > System Settings, click Keyboard in the sidebar (you may need to scroll), and click Text Replacements. Click the Add button, enter the text to replace and its replacement, click Add, and then click Done. You can also reach the same settings from inside an app by choosing Edit > Substitutions > Show Substitutions, then clicking Text Settings.

The same Apple page states the limit plainly: text replacements, smart quotes and dashes, and smart links "aren't available in all apps". That one sentence explains most of the complaints.

Check it works at all: a two-minute test

Before you change anything, find out whether the fault is your setup or the app. Work through it in this order.

  1. Open Notes or TextEdit, two Apple apps that support the feature, and type one of your shortcuts followed by a space. If it expands, your setup is fine and the problem is the other app.
  2. If it does not expand even there, go back to System Settings > Keyboard > Text Replacements and check the entry. The text in the first column is what you type, and the second is what you get. Look for a stray space or a typing slip in the shortcut.
  3. Type the shortcut and then a space or a punctuation mark. A replacement is applied when you finish the word, not as you type it, so a shortcut at the very end of a line with nothing after it may not fire.
  4. Quit the app and open it again, or log out and back in. A running app can hold an old copy of your list.
  5. In the problem app, open the Edit menu and look under Substitutions. If the app has these items, make sure the text replacement option is ticked there. Some apps turn it off for you.

Why it fails in some apps and not others

If the feature works in Notes but not in your app, the app is the cause. Apple's feature is part of the standard macOS text field. An app that draws its own editor, or runs inside a web page, may not use it. Many people report this with web apps that have their own editor, such as online documents, and with some messaging, email and office apps, and it can differ between versions. We have not tested each app, so try yours rather than assume.

A browser is a case in point. The web page, not the browser, decides how the text box behaves, and a site's editor may ignore the system's replacements. Typing into a plain text box on a simple site may work where a rich editor does not.

If you can open Show Substitutions from the Edit menu in the app, the app is at least trying to support the feature. If the menu has nothing, you are unlikely to fix it from your side.

Other things that go wrong

A few causes are not about the app at all.

  • A password field. macOS keeps keystrokes in password fields from being altered, so replacements never apply there. This is deliberate.
  • A second Mac or an iPhone that is missing the list. Apple's page points to a separate article on keeping replacements up to date across your Apple devices. A list that has not synced looks like a feature that has stopped working.
  • Chinese and Japanese input. Apple says that if you use these input sources, your replacements are included in your user dictionary, which is a different place to look.
  • A shortcut that is also a normal word. It will fire when you did not mean it, and people then switch the feature off. Pick a short, odd shortcut, such as a leading semicolon, to avoid that.

What to write as a replacement

A replacement that works well is short to type and unlikely to appear by chance. Email addresses, a postal address, a signature, a phone number and a reply you send often are all good candidates. A shortcut that is also a word, such as hello, will fire when you did not mean it.

A leading character helps. Many people start every shortcut with a semicolon or a double letter, so that it never matches normal writing. Keep the list small enough that you remember it. A list of fifty shortcuts you cannot recall helps nobody.

Replacements are plain text. If you need formatting, a line break pattern or a part that changes each time, the built-in feature is the wrong tool, and you will want something that can fill in a name or a date.

When you need it in every app

If you have done the test and your app does not support it, you have two choices: use the app's own shortcut or snippet feature if it has one, or use something that works outside the app. A small tool that types the text for you does not depend on the app supporting a macOS feature, because to the app it looks like you typing.

That is how snippets in Oplito's Clipboard work. They are off until you turn them on, and they need the Accessibility permission, because typing into another app is something macOS only allows with it. You can import the replacements you already have, so you do not start again.

Film

See Clipboard at work

A film of Clipboard, with sample content. No sound.

Questions

Why is text replacement not working in Chrome?

The web page controls how its text boxes behave, and Apple says text replacements are not available in all apps. A plain text box may work where a rich editor on the same site does not. Test in Notes first to rule out your setup.

Why is it not working in Google Docs, Word or Outlook?

Apple says the feature is not in every app, and these may use their own editors, so test each one. Some have their own autocorrect or shortcut features instead, so check the app's settings for something similar.

Why does it work in Notes but not in WhatsApp?

Notes uses the standard macOS text field. Many other apps do not, so they cannot use the feature. If the app has an Edit > Substitutions menu, look there; if not, the app is the limit.

Do text replacements sync between my devices?

Apple's page refers to a separate article for keeping them up to date across your Apple devices. If a list is missing on one device, start there.

Does text replacement work in password fields?

No. macOS protects keystrokes in password fields, so the feature does not apply there, and snippet tools cannot work there either.

Every tool. All the AI. One price.

All 30 tools and every AI feature for $99 once, or $39 a year. Try them all free for 7 days at launch, cancel any time.

One email at launch, and nothing else · macOS 26 on Apple silicon