iPhone Text Replacement not working? Try these fixes
You type your shortcut, hit space, and nothing happens. Text Replacement is handy when it works, but it depends on several other keyboard settings behaving, and it fails quietly when one of them doesn't. Here is how to track down the cause, in the order worth checking.
Quick answer
Test your shortcut in the Notes app using Apple's own keyboard, and type a space after it. If it still doesn't expand, go to Settings, General, Keyboard and make sure Auto-Correction or Predictive is turned on, then delete and re-create the shortcut. If shortcuts work on one device but not another, the cause is usually iCloud sync. As a last resort, reset the keyboard dictionary.
If you rely on saved text for work, a keyboard that inserts text when you tap a labelled key avoids most of these problems, because there is no abbreviation for iOS to miss or autocorrect.
1. Type a space or punctuation after the shortcut
Text Replacement only expands once you finish the shortcut "word". Type the shortcut, then a space or a punctuation mark such as a full stop or comma. If you type the shortcut and then tap away or send the message straight away, nothing gets replaced.
With Predictive turned on, the full phrase also appears as a suggestion in the bar above the keyboard as you type the shortcut. Tapping that suggestion inserts it too, which is a quick way to check that iOS recognises the shortcut at all.
2. Make sure you are using Apple's keyboard
Text Replacement belongs to Apple's built-in keyboard. If you have switched to a third-party keyboard, your shortcuts will usually not expand there. Tap and hold the globe or emoji key and check which keyboard is active. Our guide on how to switch keyboards on iPhone covers this step by step.
WordBoard is no exception. It doesn't expand typed abbreviations; you tap a key instead. So if you use both, switch back to Apple's keyboard when you want a Text Replacement shortcut to fire.
3. Turn Auto-Correction or Predictive back on
Text Replacement works through the same system as Auto-Correction and the predictive suggestion bar. If you have turned both off, shortcuts often stop expanding.
- Open Settings, then General, then Keyboard.
- Turn on Auto-Correction, Predictive, or both.
- If they were already on, turn them off and on again. This clears up a surprising number of cases.
4. Check the shortcut itself
Open Settings, General, Keyboard, Text Replacement and look at the entry that is misbehaving.
- Pick a shortcut that isn't a real word. Short codes that look like a typo can get autocorrected before they expand. Something unusual, like "zaddr" instead of "addr", is far less likely to clash.
- Look for duplicates. Two entries with the same or very similar shortcut can confuse things. Keep one.
- Delete and re-create it. Entries carried over from an older phone, or edited many times, sometimes stop working. Swipe left to delete it, then add it again with the + button.
- Keep the phrase short. Text Replacement was designed for short phrases. Long, multi-line text is where it is least dependable.
5. Test in another app
Try the shortcut in Notes or Messages. If it works there but not in one particular app, the problem is that app's text field rather than your settings. Some apps handle text input in their own way and don't trigger replacements reliably. There isn't much you can do from Settings in that case, except type it in Notes and copy it across.
6. Check iCloud sync between devices
Text Replacement syncs between your Apple devices through iCloud. If a shortcut you made on your Mac or iPad hasn't appeared on your iPhone, or a deleted one keeps coming back:
- Check that every device is signed in to the same Apple Account.
- Give it some time on Wi-Fi. Changes don't always arrive immediately.
- Add the shortcut directly on the iPhone where you need it, rather than waiting for sync.
7. Restart and update your iPhone
A restart clears up temporary keyboard glitches. If shortcuts broke after an iOS update, check Settings, General, Software Update for a newer release, since keyboard bugs are often fixed in point updates.
8. Reset the keyboard dictionary
If nothing else works, go to Settings, General, Transfer or Reset iPhone, tap Reset, then choose Reset Keyboard Dictionary. This removes the words your keyboard has learned from your typing, so autocorrect starts fresh. It doesn't erase your apps or data. Make a note of your important shortcuts before you do it, just in case, so you can re-create them if needed.
When Text Replacement keeps letting you down
Text Replacement is free and fine for a few short phrases, like your email address or a word you always misspell. The weak spots show up when you depend on it every day: you have to remember each shortcut, autocorrect can get in the way, and longer templates are the least reliable part.
WordBoard takes a different approach. It is a custom keyboard where your saved text appears as labelled keys. You switch to it, see "Address" or "Refund policy" on a key, and tap it. The full text is inserted at your cursor in any app.
- Nothing to remember or mistype. You pick the key by its label, so there is no abbreviation for autocorrect to change.
- Long and multi-line text. Save full email replies, support answers, and addresses over several lines.
- Folders. Group keys by client, project, or type instead of scrolling one long list.
- Variables. Insert today's date, what you just copied, or a randomly chosen greeting automatically. See iPhone keyboard variables explained.
- Backups you control. Back up your keys to iCloud and restore them on another iPhone or iPad from Cloud Backups in the More tab. This is a manual backup, not live sync, as covered in using WordBoard on iPhone and iPad.
You don't have to choose one or the other. You can keep Text Replacement for a few typo fixes and use WordBoard for everything longer. For a side-by-side comparison, see iPhone Text Replacement vs WordBoard. If you are coming from TextExpander, you can import your TextExpander snippets too.
WordBoard is free to download with 6 keys included. WordBoard Pro unlocks unlimited keys and the rest of the features above.
FAQ
Why is my iPhone Text Replacement not working?
The most common causes are not typing a space after the shortcut, using a third-party keyboard instead of Apple's, having both Auto-Correction and Predictive turned off, or a shortcut that autocorrect changes before it can expand. Check those first, then delete and re-create the shortcut.
Why do my text replacements work on my Mac but not my iPhone?
Text Replacement syncs through iCloud, and changes don't always arrive straight away. Make sure both devices are signed in to the same Apple Account, give it time on Wi-Fi, or add the shortcut directly on your iPhone.
Does Text Replacement work with Gboard, SwiftKey, or other keyboards?
Usually not. Text Replacement belongs to Apple's keyboard, so third-party keyboards generally don't expand your shortcuts. Switch back to Apple's keyboard to use them.
Will resetting the keyboard dictionary fix Text Replacement?
It can help when nothing else does. Go to Settings, General, Transfer or Reset iPhone, Reset, then Reset Keyboard Dictionary. It removes the words your keyboard has learned, so note your important shortcuts first in case you need to re-create them.
Is there a more reliable alternative to Text Replacement on iPhone?
Yes. A custom keyboard like WordBoard shows your saved text as labelled keys you tap, so there is no abbreviation to remember or for autocorrect to change. It also handles long, multi-line templates and folders. WordBoard Pro is required for unlimited keys.