macOS High Sierra and iOS 11 May Fix Long-Standing Sync Issues With iCloud Text Replacements [Update: Soon]
Sep 27, 2017 5:31 am PDT by Tim Hardwick
Apple appears to have resolved long-running iCloud sync issues linked to its text replacement feature with the release of iOS 11 and macOS High Sierra. Originally introduced in Snow Leopard and iOS 5, text replacements let users create shortcut text that, when typed, expands to something longer, thus saving input time.

The feature can be found on iOS devices in Settings -> General -> Keyboards -> Text Replacement, and in System Preferences -> Keyboard on Macs. Ideally, changes to the text snippets list on one device should sync to all devices logged in using the same Apple ID, but that hasn't always been the case, as MacStadium's Brian Stucki attests:

Text replacement syncing is completely broken. Sometimes it works, sometimes it doesn't. Sometimes it will only sync back old snippets that you have deleted. Sometimes the sync will work one direction, but not the other. Every time I ask about this on Twitter, it brings a strong response of similar experiences.
After years of struggling to get text replacement syncing to work properly, Stucki recently decided to set up a weeks-long experiment to test the reliability of the feature across hundreds of Apple devices running various versions of iOS and OS X/macOS. In short, Stucki's results suggested that the text replacement syncing service was "a complete mess" and routinely failed to sync text snippets across devices.

Following the experiment, Stucki wondered why the syncing had remained so poor across several generations of OS, given that other iCloud syncing features such as Apple Notes had improved in recent years. As noted by Daring Fireball's John Gruber, these improvements corresponded with the introduction of the CloudKit API in 2014, suggesting that text replacements had not been upgraded to run on the newer syncing framework.

However, in an update to his experiment posted on Tuesday, Stucki reported that when he made text replacement changes on a Mac running macOS High Sierra, surprisingly his edits were recognized and synced across nearly every device on the same Apple ID, regardless of OS. "Perhaps a clean install of High Sierra is now saving snippets correctly?" he wondered.

Since then, iOS developer Guilherme Rambo has claimed that text replacements do sync through CloudKit on iOS 11 and macOS High Sierra, suggesting Apple has got around to updating the feature to run on the more reliable API. So if you're having trouble syncing text snippets, updating your devices to Apple's latest operating systems might be the best course of action.

Update: An Apple spokesperson informed John Gruber later on Wednesday that an update to move text replacement syncing to CloudKit should be rolling out to iOS 11 and macOS High Sierra 10.13 "in the next month or so".

Related Roundup: macOS High Sierra

Top Rated Comments

(View all)

13 months ago
100% NO.

Synching between my iPad Pro, iPhone 7 + (both running iOS 11.01) and my Mac Pro and MacBook (both running High Sierra) are as hit and miss as they’ve always been.

Created a shortcut on my iPhone - only syncs to MacBook
Created a shortbust on my iPad - synchs nowhere
Created a shortcut on my MacBook syncs to iPhone and iPad (but not always)

Text replacement is still a heap of *****.
Rating: 4 Votes
13 months ago
Added to article:

Update: An Apple spokesperson informed John Gruber later on Wednesday that an update to move text replacement syncing to CloudKit should be rolling out to iOS 11 and macOS High Sierra 10.13 "in the next month or so ('')".
Rating: 3 Votes
13 months ago
While I’m glad, I just read posts in the iOS 11.0.1 update article commenting that it wiped their snippets on some devices and not others.

Personally, I find it maddening. After a clean install sometimes only half my snippets would appear, I’d manually redo them in that device and then 2 months later have 3+ copies of the same snippet on each device.
Rating: 3 Votes
13 months ago
I didn't even know these text replacements were supposed to sync! :p
Rating: 3 Votes
13 months ago
This thread has come out of nowhere. Like many others, it's not working for me.

It *was* working, say around 6 months ago (I don't know exactly as I haven't been changing any of my shortcuts) but I currently have three devices (iPhone iOS 11.0.1, iPad iOS 9.3.5, Macbook 10.13) and each has its own list of text replacements. Edits, additions, deletions on any of the three devices stay local.

How hard can it be to fix this? Just uncloak it so we can see the text replacements in the cloud (say at and sort it out. I'm struggling to think of ways that this function could be too complex to get working, but it seems they've found a way :)
Rating: 2 Votes
13 months ago
Actually I just realized yesterday that after a clean install of High Sierra and updating to iOS 11.0.1, my snippets were gone from all my devices.


Ironic given that Apple used to be master of synching.

Personally I'd love to just disable text snippet synching. I don't add or change them all that much and I'd much rather invest 10 minutes of my time now rather than repeatedly moan in despair how iCloud yet again ****ed up some snippets...

It may be fixed now, but code can always break again and why send something across the globe for no reason?

Glassed Silver:mac

I keep a table in Notes of all my snippets. Can’t believe how many times I’ve had to use that.
Rating: 2 Votes
13 months ago
I don't see any difference in behavior. Any iOS shortcut created is not synced to Mac. Any Mac shortcut does sync to iOS. One sided.
Rating: 2 Votes
13 months ago

This is definitely not the case. I’ve been using iOS 11 since the betas and text sync has never worked properly. Even after getting my 7 Plus replaced by Apple and doing a clean install of iOS 11, I still can’t get text replacements to sync. This is by far the most infuriating thing about using iOS for me.

Your forgot to mention Safari offline reading list. That’s only just fractionally more reliable than Text Replacement synching.
Rating: 2 Votes
13 months ago
I .... I'm in shock! I don't know what happened but I imagine aliens are involved.

My text replacements have synced! They're THE SAME on my Macbook and my phone. I just deleted one that was a test and the deletion replicated within a few seconds. I'm too scared to turn my iPad on in case the aliens get stressed out and stop syncing them.

Edit: Turned iPad on this morning. It's still being fiercely independent. iOS9 is giving the finger to iOS11 and High Sierra.
Rating: 2 Votes
13 months ago
I have exactly the same problem with Safari offline reading list and synching. Sometime it works and sometimes it doesn’t. Sometimes it saves for offline reading and sometimes it doesn’t.

Absolutely junk - has been for 2 years.
Rating: 2 Votes

[ Read All Comments ]
Newer Article Older Article