How to set up text replacement on Mac

Introduction

You type the same things over and over: your email address, your phone number, a canned reply you send ten times a day. macOS can do that typing for you, for free, with a feature called text replacement. This guide is for Mac users who want to stop retyping the same phrases. You will learn how to set it up, which shortcuts are worth adding, how to sync them to your iPhone and iPad, how to fix them when they break, and when a dedicated tool is the better call.

What is text replacement on Mac?

Text replacement is a built-in macOS feature that swaps a short abbreviation you type for a longer piece of text. Type the trigger, hit Space, and the full phrase appears.

How text replacement works

You define two things: a trigger (the short abbreviation) and its expansion (the full text). The replacement fires when you press Space, Return, or punctuation right after the trigger. macOS ships with one on by default, so typing "omw" expands to "On my way!". Add your own and the same behavior applies everywhere the feature is supported.

Where text replacement works (and where it doesn't)

It works system-wide in most native Mac apps: Mail, Notes, Messages, Pages, Safari, and plenty more. Some apps keep their own on/off switch under Edit > Substitutions, so the feature can be present but toggled off in one place while working fine everywhere else. A few third-party apps ignore the system substitution layer entirely. Microsoft Word, for example, does not support macOS text replacement. That split is worth knowing now, because it explains most of the troubleshooting later in this guide.

How to set up text replacement on Mac

You add a replacement in System Settings > Keyboard > Text Replacements in under a minute. Here is the exact path.

Add a new text replacement step by step

1. Open the Apple menu and choose System Settings.
2. Click Keyboard in the sidebar.
3. Click Text Replacements.
4. Click the "+" button at the bottom of the list.
5. In the Replace field, type your trigger (the abbreviation).
6. Press Tab, then type the full phrase in the With field.
7. Press Return to save.

Once you save it, the replacement works in any supported app. Tip: press Command + Space and search "Text Replacements" to jump straight to this screen instead of clicking through Settings.

Edit or delete a replacement

To change an entry, double-click its Replace or With text and type your edit. To remove one, select the row and click the "-" button at the bottom of the list. There is no search box in the list, so start typing a trigger to scroll to it. Deleting a replacement on your Mac also removes it from your other devices once they sync.

Tips for choosing a trigger that won't misfire

Pick a trigger you would never type by accident. Real words fire mid-sentence and drive you up the wall. A good habit is to drop the vowels or lead with punctuation, so "email" becomes ";eml" and "address" becomes ";addr". Adding special characters to a trigger keeps a shortcut from replacing text you actually meant to type.

Text replacement examples worth adding

The best replacements are the strings you type on autopilot. Here are groups worth setting up today.

Everyday phrases, email, and addresses

• Your email address: ";eml" for [email protected]
• Your mailing address: ";addr" for your full postal address
• Your phone number: ";cell" for your number
• A common sign-off: ";br" for "Best regards,"

Symbols, emoji, and hard-to-type characters

• ";shrug" for a shrug emoji
• ";sect" for the § symbol
• "(c)" for © and "(r)" for ®
• ";eyes" for an eyes emoji you reach for in chat

These save the hunt through the character viewer. macOS treats the expansion as plain text, so a trigger can stand in for a symbol you would otherwise have to look up.

Multi-line snippets and templates

Replacements can hold line breaks, so short templates work too. Set ";sig" to a two-line email signature, or ";avail" to a quick "I'm free Tuesday and Thursday afternoon. What works for you?" Keep these short. The built-in feature handles small templates well, and longer, fill-in-the-blank snippets are where a dedicated tool starts to earn its keep.

How to sync text replacements across your iPhone and iPad

Yes, text replacements sync across your Apple devices automatically. The one requirement is the same Apple Account with iCloud turned on everywhere.

What you need for sync to work

Sign in to the same Apple Account on your Mac, iPhone, and iPad, and turn on iCloud Drive on each one. Apple confirms that once iCloud is set up, a replacement you add on your Mac automatically works on your other devices, and the reverse is true too. On iPhone and iPad you will find the same list under Settings > General > Keyboard > Text Replacement.

Why replacements sometimes fail to sync

Two quick checks catch most sync problems. First, confirm every device is signed in to the same Apple Account, not a second personal or work account. Second, confirm iCloud Drive is on. If a device is signed out or has iCloud off, its list drifts out of step with the others. A signed-out device is the usual culprit, so start there before anything more involved.

Fix text replacement when it's not working on Mac

When a replacement stops firing, the cause is almost always a per-app toggle, not a broken system. Walk this checklist from top to bottom.

Re-enable text replacement inside the app

Open the app where the replacement fails, then choose Edit > Substitutions > Text Replacement and make sure it is checked. This single menu item being turned off is the most common reason replacements quit working in a specific app. If it is already checked, toggle it off and back on, which fixes cases where the setting looks right but the feature is stuck.

Why it fails in Chrome and some third-party apps

Some non-native apps do not read the system substitution layer, so replacements never fire there no matter what you toggle. Microsoft Word is a well-known example that does not support the feature, and Chrome and various Electron-based apps behave the same way. The workaround is to type your trigger in a supported app, then copy the result over, or reach for a dedicated expander that works below the app layer.

Reset or re-add a broken replacement

If one specific replacement misbehaves, delete it and add it again from System Settings > Keyboard > Text Replacements. When a trigger refuses to register, add a near-duplicate with one extra character, a trick Mac users lean on when a shortcut silently fails. As a last step, restart the app, and if that fails, restart the Mac.

Beyond the built-in feature: dedicated text expanders

The built-in feature is great for personal snippets and simple phrases. Once you need rich text, fill-in fields, or a shared team library, a dedicated expander does more.

When the built-in feature isn't enough

macOS text replacement has real limits. It stores plain text only, so no formatting. It has no fill-in-the-blank fields for things like a customer name. There is no shared library for a team, and it can quietly fail in apps that ignore the substitution layer, as covered above. For light personal use none of that matters. For heavy, structured use it adds up.

Options to consider

If you want fill-in placeholders and a shared library your team can edit, TextExpander is built for that and syncs across people, not just your own devices. If you want an open, keyboard-first setup, Espanso is free and open source and works across app types. Spud takes a keyboard-first angle too, with snippets for the text you type every day sitting alongside a searchable clipboard history so an old copy is never lost, and the option to save and restore window layouts for people who juggle several work contexts. Spud downloads directly from eatspud.com and is signed and notarized. Pick the tool that matches how structured your snippets need to be.

Summary

Text replacement is a free, built-in way to stop retyping the same phrases on your Mac. Set it up in System Settings > Keyboard > Text Replacements, choose triggers you would never type by accident, and let iCloud carry them to your iPhone and iPad. When one stops firing, check Edit > Substitutions > Text Replacement in that app first. Add a handful of your most-typed strings today, and reach for a dedicated expander only when you need formatting, fill-in fields, or a shared team library.

Frequently asked questions

How do I turn on text replacement on Mac?

Open the Apple menu, choose System Settings, click Keyboard, then click Text Replacements. Click the "+" button, type your abbreviation in the Replace field, press Tab, type the full phrase in the With field, and press Return to save. The new replacement then works in any supported app.

Why aren't text replacements working on my Mac?

The usual cause is a per-app setting that got switched off. In the app where it fails, choose Edit > Substitutions > Text Replacement and make sure it is checked, which is the most common fix. Note that some non-native apps, including Microsoft Word, ignore the feature entirely.

How do I get rid of a text replacement on Mac?

Go to System Settings > Keyboard > Text Replacements, select the entry you want to remove, and click the "-" button at the bottom of the list. Because the list syncs through iCloud, deleting it on your Mac also removes it from your iPhone and iPad once they sync.

Do text replacements sync between my Mac and iPhone?

Yes. They sync automatically when both devices are signed in to the same Apple Account with iCloud turned on. Apple confirms a replacement added on one device works on the others, so to confirm sync, check that iCloud Drive is on and the same account is signed in everywhere.