Guide
Text Replacement is not working on your iPhone. Here is which cause it is.
Six separate faults get reported as "text replacement not working". Each has a different fix - and the 128-character limit everyone repeats does not exist. We tested it on iOS 26.
Six genuinely different faults all get reported as “text replacement not working”. They have different causes and different fixes, so the usual advice - restart, delete and re-add, reset the keyboard dictionary - fixes some and does nothing for others.
Work down this list in order. The first two cover most reports.
First: the myth worth clearing
Search this problem and you will quickly meet the claim that Apple caps the replacement phrase at 128 characters, silently breaking longer snippets.
It is repeated across Apple Support threads as settled fact. We tested it, and it is not true.
On an iPhone running iOS 26 we created replacements with phrases of 100, 128, 129 and 300 characters, each ending in a marker character so any truncation would be obvious. Every one expanded in full. Nothing was cut.
| Phrase length | Expanded in full |
|---|---|
| 100 characters | Yes |
| 128 characters | Yes |
| 129 characters | Yes |
| 300 characters | Yes |
The store iOS keeps these entries in declares the phrase field with no length limit either, which matches what we saw.
One honest caveat: this tests what the keyboard expands. We did not test whether the Settings screen refuses very long text as you type it in. But if a long replacement stopped working after having worked, its length is not the reason - keep reading.
Cause 1: it expands on space, but not when you tap
The most-reported fault by a distance. You type the shortcut, the expansion appears in the suggestion strip, you tap it - and it vanishes without completing.
This is a bug in the suggestion bar, not in your entry. Press the spacebar instead of tapping. Reported on iOS 16 and still reported on iOS 26.
Nothing needs fixing in Settings. The entry is correct.
Cause 2: you are using a third-party keyboard
Text Replacement belongs to Apple’s system keyboard. Gboard, SwiftKey and any other third-party keyboard bring their own text engine and never read your Settings list.
Most articles file this under “keyboard conflicts” and suggest removing the other keyboards. That framing is wrong: this is not a conflict, it is simply not a feature those keyboards implement. Switch to the Apple keyboard with the globe key and the expansion returns immediately.
If you prefer the other keyboard, no amount of resetting will help. You need your snippets somewhere that is not Settings.
Cause 3: it works in one app but not another
Some apps use custom text views that bypass the system expansion path entirely. The classic pattern: the shortcut fires in Safari and Messages, but not in one specific app, or in every field of an app except one.
Test the same shortcut in Safari’s address bar. If it expands there, your entry is correct and the app is the variable. There is no user-side fix.
Cause 4: the entry never saved
You add a replacement, it appears in the list, and it is gone when you return. No error is shown - the failure is in saving, not in what you typed.
This correlates with iCloud being off or restricted, including when an employer’s device management disables it. Check Settings › [your name] › iCloud and confirm iCloud Drive is on, then re-add the entry.
Cause 5: it syncs to one device but not back
Replacements made on the iPhone appear on the iPad but not the reverse, or sync stops in one direction.
The reliable nudge: add a throwaway entry on the device that is behind, then delete it. That forces a sync push and usually brings the rest across.
A related quirk explains a common complaint - deleted entries reappearing. iOS does not remove a deleted replacement from its store; it flags it as deleted and keeps the row so the deletion can sync. If that flag does not propagate cleanly, the entry can return. Nothing you can fix from Settings, but it does mean the behaviour is not imagined.
Cause 6: an update wiped the list
Some iOS and iPadOS updates have reset Text Replacement to the single default
omw entry, deleting everything else. Users have reported losing hundreds of
entries this way, with re-created entries deleted again on the next reset.
There is no recovery path on the device. If this has happened, the entries are gone.
When Settings is the wrong place for this
Causes 1, 4, 5 and 6 share a root: Text Replacement is a small system setting with no visibility into its own failures. It gives no error when a save fails, no indication when sync stalls, and no warning before an update clears it. You find out when a message does not expand in front of a customer.
That is a reasonable place to stop using it for anything that matters. Text Replacement is genuinely good for a handful of short strings - your email address, a booking link. For replies you depend on, a library that shows you what you saved, survives updates, and works regardless of which keyboard you are using is a different kind of tool.
Fast Reply keeps replies in an app you can browse, with fill-in-the-blank fields for the parts that change per conversation, and a keyboard that works in any app. Nothing lives in Settings, so nothing an update does to Settings can clear it.
For what Apple’s Text Replacement does well and the four walls you hit, see iPhone Text Replacement: what it does and where it stops.
Common questions
Is there a 128-character limit on iPhone text replacement?
No. This is repeated constantly in Apple Support threads, but we tested phrases of 100, 128, 129 and 300 characters on iOS 26 and all four expanded in full with nothing truncated. The underlying database stores the phrase with no length constraint. If a long snippet stopped working, the length is not the reason.
My shortcut expands when I press space but not when I tap the suggestion. Why?
This is the single most-reported Text Replacement fault and it is a bug in the suggestion bar, not in your entry. Tapping the suggestion can dismiss it without completing the word. Press the spacebar instead - the entry itself is fine.
Why did my text replacements disappear after an iOS update?
Some updates have reset the list to the single default omw entry. The replacements are not recoverable from the device once this happens, which is the strongest argument for keeping anything you rely on outside Settings.
Do text replacements work in Gboard or other third-party keyboards?
No, and this is not a bug. Text Replacement is a feature of Apple’s system keyboard. A third-party keyboard supplies its own text engine, so it never sees your Settings list. Nothing you change in Settings will fix this.
Why does my replacement work in one app but not another?
Some apps use custom text views that bypass the system expansion path. If the same shortcut works in Safari but not in a particular app, the entry is correct and the app is the variable.