How to Use Text Replacement on Mac to Type Faster

BY Khamosh Pathak

Published 10 Apr 2016

text replacement mac featured

As much as we’d like it, typing isn’t dead. Voice recognition still has a long way to go. Either you’re like me and you write for a living, or you work in finance and most of your working hours are spent writing reports. It could be any number of things really. But if you write a lot, you end up writing the same thing, over and over again.

It could be as simple as your office address, your email or something more complicated like an email template, snippets of laws, anything really.

And if you’re a pro user, you’d want to automate such a process. Thankfully, OS X has such a utility built right in. It’s called Text Replacement.

What Is Text Replacement?

In general, the term is called text expansion. But OS X being OS X, uses its own moniker. Actually, it doesn’t even do that. The feature in System Preferences is kind of nameless. It just exists under “Text” section.

Text expansion (or text replacement, or text substitution) is a process of typing a shortcut or snippet which is automatically converted to a longer string of text by OS X.

So let’s say I type in “@@“ and if I’ve set it up in a particular way, it will automatically change to “[email protected]” right after I hit that space bar.

You can do this for anything you want. Frequent typos you make, product names that are hard to remember and more.

But how exactly? Let me show you.

How to Set Up Text Replacement

To get started, click the “Apple” icon from the menu bar and select “System Preferences”.

text replacement mac 4

Here, go to “Keyboard” and navigate to the “Text” section.

text replacement mac 5

You’ll see a section on the left which has two parts – “Replace” and “With”.

text replacement mac 1

Click the “+” icon in the bottom right to add a new shortcut.

text replacement mac 3

Type the snippet (the shortcut) in the “Replace” section and what you want it to expand to in the “With” section.

That’s it. Do it for all the snippets you can think of. Open an app like TextEdit and try them out.

Troubleshooting: Enable Text Replacement in Apps

Some apps might not enable the Text Replacement feature by default. If you come across an app that doesn’t support this feature, there’s a way to turn it on an app by app basis.

Open the app in question and from the menubar, select “Edit” and go to “Substitutions” menu. From here, enable the “Text Replacement” option.

text replacement mac 2

If you don’t want to do this one by one and you’re familiar with using the Terminal, there’s a command you can use to enable Text Replacement for all apps.

Open Terminal, paste the following command and press Enter.

defaults write -g WebAutomaticTextReplacementEnabled -bool true

One Problem: Doesn’t Work With Chrome

The above command only works for apps that do support Text Replacement but have the featured turned off.

If your browser of choice is Chrome, this might be a problem. Text Replacement feature is flat out disabled in Chrome. It works like a charm in Safari though. But if you can’t let go of Chrome, you might want to look into third party text expansion utilities. Speaking of which.

Alternatives and Going Pro

I think using Text Replacement on OS X is a great starting point in your text expansion productivity journey.


If you like the idea but you want a bit more features (and a lot more control), I suggest you look into aText. It’s currently the best text expansion utility for the price – $5 and has pro features like macros, Apple Script support, clipboard entry and a lot more.

Lastly, Proper Text Expansion Etiquette

If you’re new to the text expansion game, here are some helpful tips and tricks that will make you a pro in no time.

  • Don’t use dictionary words as snippets.
  • Keep the snippets short – 4 to 5 letters is the sweet spot.
  • Just to reduce confusion and error, create a system where you use modifier keys before the shortcut. So let’s say, a shortcut begins with a comma. For example: “,addrs”.
  • Create snippets of both proper terminology and words you misspell often. For example: “gb” could turn in “GB”, “teh” could turn into “the” and so on.

What are some of your favorite text expansion hacks? Share with us in the comments below.

Related: How to Use Text Replacement on iPhone and iPad