Text Replacement on Mac: How to Set It Up, Sync It, and Fix It

Text replacement on Mac is a free, built-in macOS feature that turns a short code into a longer word, phrase, or link as you type. To create one, choose Apple menu > System Settings > Keyboard, click Text Replacements, click the plus sign, then enter your shortcut and the full text. Your entries sync to your iPhone and iPad through iCloud when each device uses the same Apple Account.

If you’re a knowledge worker, business owner, sales rep, or marketer who keys in the same thing over and over, this is a quick win for your productivity. This guide shows you how to create codes, sync them, fix them when they stop firing, and where Apple’s tool falls short.

What Is Text Replacement on a Mac?

You’re probably asking yourself, “What exactly is a text expander?” It’s a tool that swaps a short code for a longer string of words. Think about phrases you type every day, like your company address. Wouldn’t it be easier to type “addr” and have the full address appear?

Beyond fewer keystrokes, it cuts down on mundane tasks and keeps your messages consistent. And what’s cool is, you already have one built in. Apple’s version runs in many programs, including Mail, Messages, Notes, and Safari.

How to Set Up Text Replacement on Mac

These steps match current versions of macOS. Older versions (Monterey and earlier) say System Preferences instead, but the path is the same.

1. Click the Apple menu in the menu bar at the top left of your screen. You can also open settings from the Dock.
2. Choose System Settings, then Keyboard in the sidebar. You may need to scroll down.
3. Click Text Replacements, then the plus sign (+).
4. Each entry has two parts. Put the short code in the Replace field, like “teh,” and the longer phrase in the With field, like “the.”
5. Click Add, then Done.

Now enter your code in a supported program and press the space bar. macOS swaps in the full phrase.

You can also reach the same list from inside an app: choose Edit > Substitutions > Show Substitutions, then Text Settings. Apple’s guide to replacing text and punctuation on Mac is helpful if you want the extras too, like smart links that make a URL clickable.

Tip: Want a faster way to end a sentence? In Keyboard settings, go to Text Input, select Edit, and turn on “Add period with double-space.”

Change or Remove an Entry

Head back to the Text Replacements window. Double-click an entry to change it. To delete one, select it and click the minus sign (-).

Use Text Replacements on an Existing Document

Apple’s tool also fixes existing copy. Select the words, choose Edit > Substitutions > Show Substitutions, make sure the Text Replacement checkbox is selected, then click Replace in Selection. Click Replace All to fix the whole document.

Start With a Few Shortcuts You Use Every Day

Don’t build 100 shortcuts on day one. Start with five you need daily, use them for a week, then add more. Try these examples:

• “-addr” for your full business address
• “-cal” for your calendar booking link
• “-sig” for your name, title, and phone number
• “-ty” for “Thanks for your time today. I’ll send next steps by DATE.”
• “(c)” for the © symbol, or a short code for an emoji you use often

Got a favorite? Share it in a comment below.

Pick Codes That Won’t Fire by Accident

The built-in tool can trigger when you don’t want it to. If a code is a word you use often, it will fire every time you type that word.

A simple rule: give every code a distinctive prefix, like a dash. “-addr” instead of “addr.” No real word starts with a dash, so the swap only happens when you mean it.

How to Sync Text Replacements Across Apple Devices

If juggling a laptop, phone, and tablet sounds daunting, don’t fret. Your codes sync through iCloud Drive, allowing you to create one on your Mac and use it on your phone. Turn on iCloud Drive on your Mac, iPhone, and iPad, and sign in to the same Apple Account on each one.

On a Mac

1. Go to your settings and click your name at the top of the sidebar.
2. Click iCloud, then Drive, then turn on Sync this Mac.

On an iPhone or iPad

1. Open the Settings app and tap your name.
2. Tap iCloud, tap See All, tap iCloud Drive, then turn on Sync this iPhone.

Want to use text replacement on your phone too? To add a code, go to Settings > General > Keyboard > Text Replacement and tap the plus sign. Put the full phrase in the Phrase field and your code in the Shortcut field. Apple’s iPhone guide has the details.

My advice: use the exact same codes on your phone that you use on your computer. One group of codes everywhere means your muscle memory kicks in without thinking. I still use Apple’s tool on my iPhone for exactly this reason.

Back Up or Move Your Codes

Switching to a new Mac? Back up first. In your settings, go to Text Replacements, select the entries you want, and drag them to your desktop. That exports them to a .plist file named “property list.plist.” On the new computer, drag that file into the same window and click Done.

It’s doable, but it’s manual, and you have to remember to do it. #PainInTheButt. Apple explains the steps in its guide to backing up and sharing text replacements.

Why Aren’t Text Replacements Working on My Mac?

Apple’s tool can act like a stubborn mule. Work through these fixes in order.

1. Check That the Program Supports It

Apple says the feature isn’t available in all apps. Check this first, like checking for gas before blaming the engine.

Microsoft Word for Mac is a common example. It uses its own engine and AutoCorrect, so it ignores macOS entries, according to a Microsoft Q&A answer. In Word, add your codes to AutoCorrect instead.

2. Check the Edit Menu

In the program, go to the Edit menu, choose Substitutions, and look for a checkmark next to Text Replacement. No checkmark? Choose it. If it’s already checked, toggle it off and back on. This option is per program, so a code can fire in Notes and not somewhere else.

3. Delete and Re-Add the Code

Sometimes a little nudge does wonders, like shaking a ketchup bottle. Delete the code, add it again, then test it.

4. Confirm iCloud Sync Is On

If a code fires on your iPhone but not on your laptop, confirm iCloud Drive is on and both use the same Apple Account.

5. Keep macOS Up to Date

Running old software is like driving around town without updating your maps app. In your settings, go to General, then Software Update, and install any updates.

6. Restart

When everything else fails, restart. It sounds simple because it really is, and it can clear a glitch faster than you can say “apple pie.”

The Limits of Mac Text Replacement

Apple’s tool is free, simple, and syncs across your Apple gear. For short phrases, it’s hard to beat. But it has real limits.

It Doesn’t Run Everywhere

Word and other programs with their own engines ignore it. This is one of the main reasons I don’t rely on it on my desktop. I need text expansion in other apps, and in the cloud.

Plain Text Only

I build snippets with several paragraphs, bold, italics, hyperlinks, and images. That formatting doesn’t carry over in Apple’s tool. Your phrase comes through as plain text.

Built for Short Phrases

If you’re a power user who swaps out long LinkedIn posts, comment replies, or canned responses, the built-in tool might not be enough. I drop in multiple paragraphs at once.

Apple Only

Your codes live in your Apple Account. Sit down at a Windows PC at the office and they’re gone. If you split your day between both, look at a text expander for Windows that runs on both.

No Folders or Search

Once you have dozens of codes, you’re going to forget them. Apple gives you one long list with no categories.

Not a Place for Passwords

For security, don’t store passwords or account numbers as codes. Entries sync through iCloud and expand anywhere you enter the code.

Frequently Asked Questions

Can you do text replacement on a Mac?

Yes. macOS has a free, built-in tool for it. Go to Keyboard settings, click Text Replacements, and click Add (+) to enter a code and the phrase it should become.

Why aren’t text replacements working on my Mac?

Start with the program. It may not support them, or it may have them switched off. Check Edit > Substitutions for a checkmark next to Text Replacement, and toggle it off and on. If that fails, re-add the code, confirm iCloud Drive is on, update macOS, and restart.

How do I get rid of text replacement on Mac?

To delete one entry, go to Text Replacements in your settings, select it, and click the minus sign. To stop it in one program, choose Edit > Substitutions and click Text Replacement to remove the checkmark.

What is the shortcut key for replacing text?

Apple’s codes don’t need a keyboard shortcut. They fire as you type. To swap one word for another in a document, press Command-F, which brings up Find in most apps. In TextEdit, choose Edit > Find > Find and Replace.

Does Mac have a text editor like Notepad?

Yes. TextEdit comes free with macOS, in your Applications folder. It supports Apple’s substitutions, which makes it a helpful place to test a new code.

Is Apple’s tool the same as a text expander?

It’s a helpful but simple text expander. It handles short, plain-text phrases in Apple apps. For formatted messages, long templates, and websites in Chrome or Edge, a browser text expander like FlyMSG does more.

When a Browser Text Expander Is the Better Solution

You’re not the only one retyping the same words. In a 2023 Loom survey of 1,500 U.S. desk workers, 85% of people said they send the same messages or information multiple times or in multiple places at least weekly, and 69% do it every day.

That’s where a browser-based text expander helps. The FlyMSG Auto Text Expander runs inside Chrome and Edge on your Mac or PC. Your snippets, called FlyCuts, expand on the websites where you do most of your writing.

• Runs across the web: FlyCuts expand in Gmail, Outlook on the web, your CRM, and LinkedIn, whether it’s a message, a comment, or one of your posts.
• Rich text: Save bold text, links, and images in a FlyCut, and test it as rich or simple text before you use it.
• Long messages: Proposals, scripts, and multi-paragraph replies expand as easily as one word.
• FlyPlates: Start from a library of ready-made templates for posts, replies, and more instead of a blank page.
• Categories and search: Sort FlyCuts into categories and subcategories, and search by keyword when you forget one.
• Sharing: Teams can work from the same approved snippets, so answers stay on brand.

One FlyMSG user described FlyCuts in Gmail and LinkedIn this way: “FlyMSG has an easy to use interface for setting up FlyCuts and integrates well with Gmail and LinkedIn. The text expander function is really useful for repetitive tasks and messages.” (FlyMSG user)

I use FlyCuts like this. When a buyer asks to book a meeting, I don’t dig through old emails to copy my scheduling note. I enter “bookameeting,” and my full message with my calendar link drops into the reply, ready to send.

FlyMSG is more than a text expander. The AI Grammar Checker catches typos before you hit send on an email or a comment. The LinkedIn Comment Generator helps you leave a thoughtful comment in seconds, and the LinkedIn Post Generator drafts ready-to-edit LinkedIn posts from an idea. FlyMSG users have saved 284,539+ hours and typed 3.4 billion+ characters with FlyMSG.

To be clear about what it doesn’t do: FlyMSG is a browser extension for Chrome and Edge. It doesn’t run in Safari, in desktop apps like Apple Mail or Pages, or on your iPhone. For those, keep using Apple’s tool, ideally with the same codes. The two make a strong team.

Watch how to access your FlyCuts anywhere online on the Vengreso YouTube channel, then install FlyMSG free on Chrome or Edge.

Ready to go beyond the free plan? Use code 20PercentYr1 at checkout to get 20% off your first year on an annual paid plan.