Quick answer
Toggle iCloud Drive off and on in Settings, then pull-to-refresh the Files app or Photos tab to jolt the sync queue.
Why this happens
I've seen this on every iOS version from 14 to 17. The 'Waiting to Upload' message pops up when iCloud hits a snag—usually a weak Wi-Fi signal, a large file that keeps failing, or a stuck background task. iOS 16 and 17 are particularly picky about Wi-Fi connections that drop for even a second. When that happens, the upload job doesn't reset automatically. It just sits there, spinning its wheels, waiting for a signal that never comes.
I know this error is infuriating because it freezes everything—your photos, your Files, even your backups. The good news is that it's almost never a data loss issue. Your files are still on the device; they just aren't reaching Apple's servers. Here's how to fix it without nuking your phone.
The fix: force the sync queue to reset
- Check your Wi-Fi first. If you're on a 5GHz network that's spotty, switch to 2.4GHz or move closer to the router. A stable connection is non-negotiable for iCloud. I've had clients stuck for days because their office Wi-Fi kept dropping packets.
- Turn off iCloud Drive (or Photos, if that's where you're stuck). Go to
Settings > [Your Name] > iCloud. Toggle off 'iCloud Drive' (or 'Photos' if that's the culprit). Wait 30 seconds, then toggle it back on. This forces iOS to rebuild the sync queue from scratch. - Pull to refresh. Open the Files app or Photos app and pull down from the top of the list. You'll see a spinner—let it finish. This manually triggers a new upload attempt.
- If it's still stuck, restart your iPhone. Hold the power button and volume up (or just power on older models) until 'slide to power off' appears. Wait 10 seconds, then power back on. This clears any background sync processes that are hung.
- For Photos specifically: Go to
Settings > Photosand toggle off 'iCloud Photos'. Wait 60 seconds, then toggle it back on. This is more aggressive than toggling iCloud Drive and often works when the generic fix doesn't.
Alternative fixes if the main steps fail
If toggling didn't cut it, here's the next level:
- Reset network settings. Go to
Settings > General > Transfer or Reset iPhone > Reset > Reset Network Settings. This wipes Wi-Fi passwords and VPN configs, so you'll need to reconnect to your network. But it clears any corrupted network state that might be blocking the upload. It's drastic, but I've seen it fix a month-long 'Waiting to Upload' on iOS 16.3. - Delete the stuck file. If you know which file is causing the trouble (usually a huge video or a PDF over 500MB), delete it from your device, let sync settle, then re-add it from a backup or another source. I once had a 3GB 4K video that refused to upload—deleting it was the only way.
- Use cellular data. If you have a generous data plan, turn off Wi-Fi completely and try uploading over LTE/5G. This bypasses any Wi-Fi router issues that might be interfering. Just remember to enable 'Cellular Data' for iCloud Drive in
Settings > Cellular.
Prevention: stop it from happening again
The best way to avoid this headache is to keep your uploads small and frequent. If you're uploading a ton of photos before a trip, do it in batches of 50–100. Also, make sure your iPhone is plugged in and on stable Wi-Fi when you're uploading large files—iOS often pauses uploads when the battery is low.
Another tip: update to the latest iOS. Apple fixed several sync bugs in iOS 17.4 and 17.5 that caused these loops. If you're on an older version, that might be your root cause.
Pro tip: If you're in a hurry, just turn on 'Low Power Mode' temporarily (Settings > Battery). It sounds counterintuitive, but it forces iOS to reduce background activity, which sometimes kick-starts a stuck upload.
That's it. Usually, the toggle-and-refresh combo does the trick in under two minutes. If it doesn't, the network reset is your best bet. And remember—your files are safe, so don't panic and start deleting things.