How to Set Up Text Expansion on Mac
Type a short keyword and get your email address, signature or a whole template. How to set up text expansion on Mac with Raycast Snippets, or with macOS Text Replacements.
Type a short keyword and get your email address, signature or a whole template. How to set up text expansion on Mac with Raycast Snippets, or with macOS Text Replacements.
You type the same things all day: your email address, a meeting link, "Thanks for reaching out", a code block you always need.
The short answer: use Snippets in Raycast. It's built in and free. Run Create Snippet, paste your text and give it a keyword like !sig. From then on, typing !sig in any app replaces it with your signature. macOS also has Text Replacements in System Settings → Keyboard, which works for short, plain text.
| Method | Works in | Dates, clipboard, cursor | Import from other tools |
|---|---|---|---|
| Raycast Snippets | Almost any app | Yes | Yes |
| macOS Text Replacements | Many native Mac apps | No | No |
!email or ;;addr, and save.Pick keywords you'd never type by accident. A symbol at the start, like !, ;; or /, does the trick. Spaces, quotes and backticks can't be part of a keyword.

To find a snippet without its keyword, run Search Snippets. You can search by name, keyword or content, filter by tag, and paste it into the app you're in.
A few ideas to start with:
!sig for your email signature.;;log for console.log({cursor}).!zoom for your meeting link.!shrug for ¯\_(ツ)_/¯.Browse ray.so/snippets for more ideas.
In Settings → Snippets:
Run Import Snippets to bring your library from TextExpander, aText, Espanso or PhraseExpress. On a team, shared snippets keep support replies and company boilerplate the same for everyone.
Snippets work on Windows too.
Here's a two-minute tour of Snippets:
macOS has a simple text expander of its own.
Text Replacements sync across your Apple devices with iCloud. They're plain text only, so there are no dates, clipboard or cursor placeholders, and apps with their own text fields, like many code editors and some web apps, often ignore them.
Here's a quick tour of what else it can do, in under seven minutes:
Yes. Text Replacements in System Settings → Keyboard swaps short text for longer text and syncs over iCloud. It's plain text only, with no dates, cursor position or clipboard, and some apps ignore it.
Something you'd never type by accident. Start keywords with a symbol, such as !email, ;;addr or /sig. Spaces, quotes and backticks can't be used in Raycast keywords.
Yes, with dynamic placeholders in Raycast Snippets. {date} inserts today's date, {clipboard} your last copied text, and {cursor} sets where the cursor ends up after the snippet expands.
Yes. Export your snippets from TextExpander, aText, Espanso or PhraseExpress, then run Import Snippets in Raycast and select the file.
Check that Enable Snippet Expansion is on in Settings → Snippets and that Raycast has Accessibility access. Password fields and some apps, like terminals and virtual machines, block expansion. In those, paste the snippet from Search Snippets instead.
More guides
Type with your voice in any app on your Mac. How to turn on the built-in macOS dictation, and how Raycast Dictation turns speech into clean, formatted text that fits the app you're in.
Fix typos and grammar in any app on your Mac with one hotkey. How Raycast's Quick Fix works, what macOS can do on its own, and how it compares with Grammarly.
Pretty-print messy or minified JSON on Mac without pasting it into a website. Use the Format JSON extension for Raycast, or jq and Python in Terminal.
Paste text without the fonts, colors and links it came with. The Mac shortcut for paste and match style, which apps support it, and how to always paste plain text with Raycast.
