Text expansion

How to create text shortcuts on Mac

Updated · Applies to macOS 14 Sonoma through macOS 27 Golden Gate

Short answer

Open System Settings → Keyboard → Text Replacements, click +, and enter a short “Replace” text and the full “With” text. Type the shortcut followed by a space or punctuation in most Apple apps and it expands.

macOS has a simple text shortcut feature built in. It’s free, it syncs through iCloud, and for a handful of phrases it may be all you need.

Set up Text Replacements

  1. Open System Settings → Keyboard.
  2. Under Text Input, click Text Replacements…
  3. Click +. Type your shortcut under Replace (for example @@) and the full text under With (your email address).
  4. Click Done. In a supported app, type @@ followed by a space and it expands.

Where Text Replacements falls short

When a text expander app is worth it

A text expander app watches for your abbreviations in every app and replaces them itself, which is why it works in Terminal and Electron apps too. It also adds placeholders: dates with maths, your clipboard, fields to fill in before the text is inserted, and snippets inside snippets. See how text expansion works on macOS for what’s going on under the hood, and choosing a text expander for the options.

Snippets worth creating first