← Photo Clinic

Answers

iCloud Photos seems stuck syncing on my Mac. Is it slow or stuck?

Short answer: a big library can take days or weeks to sync, so slow is normal. Look for signs that it is not moving at all, and check Apple's own status first.

Download for Mac

Check the easy things first

Slow or stuck?

From the outside they look the same. What tells them apart is whether the numbers move over hours. Photo Clinic takes a reading of your library every 15 minutes and shows the trend: the size of iCloud's sync queue should shrink over time. It only calls a library stuck when every sign agrees: the merge has run for hours, the queue has not moved, and the sync process is busy.

What not to do

Where to look next

Photo Clinic reads the hidden Photos and iCloud messages and explains them in plain words. It also has step-by-step fix guides, such as "iCloud Photos is stuck, paused or never finishes". Many of the explanations are our best reading, because Apple does not document them, and each one says how sure we are. See Find problems.

More answers

How long should it take?

Upload speed is the limit, and home connections upload far more slowly than they download. A quick sum: 100 GB is 800,000 megabits. At 20 megabits per second that is 40,000 seconds, about 11 hours, if nothing else uses the connection and the Mac stays awake. At 5 megabits per second it is about 44 hours. Photos also uploads in the background and slows down when the Mac is busy, on battery, in Low Power Mode, or on a connection marked as limited.

Things that pause syncing without telling you

Reading the numbers

In Photos, the status line at the bottom of the Library view shows how many items remain to upload. If that number goes down over hours, even slowly, the sync is working. If it stays the same for a day with the Mac awake and online, something is stopping it. Photo Clinic's Sync meter draws this as a chart, and separates the number of photos waiting from the internal records the sync engine keeps, which can grow without anything being wrong.

Look at your library for free

Download it, point it at your photos, and read the preview. That costs nothing and changes nothing.

Download for Mac

Free · Apple silicon Macs · signed and checked by Apple