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 MacCheck the easy things first
- Is Apple having a problem? Check Apple's system status page. Photo Clinic can check it for you.
- Is the Mac plugged in and awake? Low Power Mode pauses background syncing.
- Is there free space on the Mac, and room in your iCloud plan?
- Is Photos open, and is iCloud Photos turned on?
- Give it days, not minutes, before deciding anything is permanently stuck.
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
- Do not repair the library just because it is slow. Repairing is for real damage.
- Do not keep restarting services. It can make things worse.
- Do not delete anything to make it go faster.
- If it really is stuck, keep the evidence and leave the library alone while you check.
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
- Google Takeout photos show the wrong date
- How to fix Google Takeout metadata on a Mac
- What are the .json files in a Google Takeout?
- How to move from Google Photos to Apple Photos
- How to find and remove duplicate photos on a Mac
- How to sort photos into folders by date on a Mac
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
- Low Power Mode on a laptop, and Low Data Mode on the network.
- The Mac asleep or on battery. Syncing runs best when plugged in and awake.
- Full iCloud storage. Uploads stop when your plan is full.
- “Pause for a day” in Photos' iCloud settings.
- A signed-out Apple Account, or one that needs you to sign in again.
- One file it cannot upload, such as a damaged picture, which can hold things up.
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 MacFree · Apple silicon Macs · signed and checked by Apple