How to Create Custom Keyboard Shortcuts for Text Replacement on macOS

Typing the same long phrases, email addresses, or complex technical terms repeatedly is a massive drain on productivity. macOS includes a deeply integrated Text Replacement feature that acts as a universal macro system. It allows you to create short, custom abbreviations (like “@@”) that instantly expand into full paragraphs or complex strings (like your full business email address) across almost every app on your Mac.

Unlike third-party text expansion apps that run in the background and drain battery life, Apple’s native solution is baked directly into the operating system and syncs seamlessly via iCloud to your iPhone and iPad.

How to Create a Text Replacement Shortcut

1. Click the Apple Logo () in the top-left corner of your menu bar and select System Settings.
2. Scroll down the left sidebar and click on Keyboard.
3. In the main window, look under the “Text Input” section and click the Text Replacements… button.
4. A new window will appear showing any existing shortcuts. Click the + (Plus) button at the bottom left to create a new one.
5. In the Replace column, type the short abbreviation you want to use (e.g., addr or ;;em).
6. In the With column, type the full text you want the abbreviation to expand into (e.g., 123 Fake Street, London, UK).
7. Click Add to save the shortcut.

Best Practices for Creating Abbreviations

The biggest mistake people make with text replacement is choosing abbreviations that are real words. If you set “address” to expand into your home address, you will accidentally trigger it every time you try to type the normal word.

To prevent accidental triggers, adopt a specific prefix syntax for all your shortcuts. Common strategies include:

• Double Punctuation: Start shortcuts with two semicolons (;;email) or two commas (,,phone).
• The X Prefix: Start shortcuts with the letter X, which rarely begins an English word (xaddr).
• Symbol Prefixes: Use the @ symbol for email shortcuts (@@work, @@personal).

How to Use Text Replacement

Using your new shortcuts is completely seamless. Open any native macOS application—such as Mail, Messages, Notes, or Safari—and type your abbreviation. The moment you press the Spacebar or Enter key, the operating system will instantly swap the abbreviation for your full text snippet.

Note: Text Replacement relies on the macOS spell-checking engine. It will work flawlessly in native apps, but third-party applications that use their own custom text rendering engines (such as Microsoft Word or certain code editors) may occasionally ignore the shortcuts.