Messages in iCloud stuck uploading or syncing: what to try

Short answer

Check that the iPhone and Mac use the same Apple Account, that iCloud has free space, and that both are online, then click Sync Now on the Mac and leave both plugged in. If it is still stuck, make a cable backup of the iPhone and export from that rather than waiting.

TextExhibit showing a connected iPhone and a Back Up Now button
An iPhone connected by cable, ready to back up. The device shown is a sample.

Checks in order

  1. Confirm the same Apple Account on both devices.
  2. Open Settings, your name, iCloud and make sure storage is not full.
  3. Update iOS and macOS to the latest versions.
  4. Connect both to Wi-Fi and power.
  5. On the Mac, click Messages, Settings, iMessage, Sync Now.
  6. Restart both devices.

Signs of a stuck sync

  • The iPhone shows an old "Updating" bar for many hours.
  • The Mac shows the newest threads but the oldest never appear.
  • Counts of messages differ between devices.

Do not do these

  • Do not turn off Messages in iCloud and delete the Mac copy before backing up.
  • Do not sign out of iCloud as a first step.

Export without waiting

A Finder backup of the iPhone has the phone’s own copy, so an export can proceed even if iCloud sync is slow. See exporting without iCloud.

How to tell where it is stuck

  • On the iPhone, plug in, join Wi-Fi and wait; most stalls are the phone not being allowed to upload in the background.
  • On the Mac, a new message sent from the iPhone appearing within moments tells you live sync works, even if history is still catching up.
  • If live sync fails too, the problem is the account or network, not the size of the history.

When to stop waiting

If a day or two passes with no change and storage is fine, treat the sync as unreliable and move to a copy you control. A cable backup takes an afternoon at worst and does not depend on Apple servers.

What to keep in mind

  • Apple does not give a time limit for a first sync; big histories can take a long time.
  • Some stalls are on Apple’s side and clear without any action.
  • If the problem continues, Apple Support can look at the account.

Questions

How long should a first sync take?

Apple only says it may take some time. Hours is common for large histories.

Does it need Wi-Fi?

Large syncs are best on Wi-Fi.

Can I check progress?

There is no meter. Check the oldest thread on the Mac.

Sources

Export the whole conversation

TextExhibit turns a conversation into one PDF with exact times, names and numbers, photos in place and page numbers, on your Mac. Free to preview; $24.99 once to export.