iCloud Drive Stuck on 'Waiting to Upload'
Your files sit in iCloud Drive with a 'waiting to upload' status that never clears — days pass and nothing syncs. The queue is usually jammed by one stuck file, a full iCloud storage, or a paused sync. This guide unjams the queue without losing files.
TL;DR / Quick Fix
Quick fix: check that iCloud storage is not full and the Mac has a stable connection. Pause and resume iCloud Drive sync, then find the stuck file — often a huge or oddly-named one — and move it out of iCloud temporarily.
Follow these steps
- Check iCloud storage space. Go to System Settings > Apple ID > iCloud and check the storage bar. A full iCloud cannot accept uploads, and the queue waits silently instead of telling you clearly.
- Confirm a stable connection. Make sure the Mac is on reliable Wi-Fi, not a hotspot or captive portal. iCloud pauses uploads on poor connections and resumes without fanfare when the network improves.
- Pause and resume iCloud Drive. Turn iCloud Drive off and back on in the iCloud settings. This restarts the sync engine and clears a jammed queue without deleting local files.
- Find the stuck file. Look for the file with the oldest 'waiting' status — often a very large file or one with unusual characters in its name. Move it to the Desktop temporarily and watch the queue unjam.
- Restart the Mac. A restart clears stuck sync daemons. After logging back in, give iCloud ten minutes before judging — the queue restarts slowly by design.
- Check for a macOS update. Sync bugs get fixed in updates. If the queue jams repeatedly, install any pending macOS update before assuming your files are the problem.
What NOT to do
- Do not delete the 'waiting' files to clear the queue. Deleting may remove the only copy if the file never uploaded.
- Do not turn off iCloud Drive in a panic without reading the prompt. Choose to keep a local copy of files when macOS asks.
- Do not rename dozens of files at once to unstick them. Mass renames create a bigger sync job and jam the queue further.
- Do not assume the files are lost. 'Waiting to upload' means the local copies are safe on your Mac — the problem is the upload, not the files.
Frequently asked questions
Why is iCloud stuck on waiting to upload?
A full iCloud, a poor connection, or one stuck file blocking the queue. Check storage first, then the network, then the oldest waiting file.
How long should iCloud upload take?
Minutes for documents, hours for gigabytes of video. Days of 'waiting' with no progress means the queue is jammed.
Will restarting delete my waiting files?
No. Restarting only restarts the sync process; your local files stay exactly where they are.