When iCloud Drive stalls, files may not appear on iPhone, iPad, or another Mac, and Finder may show spinning cloud icons or warning symbols. The cause is usually connection, storage, account mismatch, or a stuck background sync process.
This applies to recent macOS versions with iCloud Drive enabled.
Does This Affect You?
Use these steps if files saved on the Mac do not show up elsewhere, or if iCloud Drive in Finder seems stuck uploading or downloading.
Check Connection and Restart iCloud Drive
- Confirm the Mac is online by opening a website.
- Open Finder and check iCloud Drive for stuck cloud or warning icons.
- Open System Settings, click your name, then open iCloud.
- Open iCloud Drive.
- Turn iCloud Drive off, wait about 10 seconds, then turn it back on.
- Give Finder a few minutes to update, especially if many files are syncing.
Check iCloud Storage
- Open System Settings > your name > iCloud.
- Review the storage bar.
- If storage is full or nearly full, open Manage Account Storage.
- Remove unneeded data or upgrade iCloud+ storage.
- After freeing space, return to Finder and wait for files to resume syncing.
More iCloud Drive Fixes
Confirm the Apple Account
The Apple Account on the Mac must match the one used on the other devices. If it differs, files will not sync between them.
Check Apple System Status
iCloud Drive outages happen. Check Apple’s system status page before changing lots of settings if everything looks correct locally.
Fix One Stuck File
Move the stubborn file out of iCloud Drive and back in, or rename it slightly. Very long names or unusual characters can sometimes block a single item.
Restart the Mac
A full restart can clear a stuck iCloud background process after toggling iCloud Drive is not enough.
Sources
- Apple Support: If iCloud Drive is not working on your Mac
- Apple Support: Manage your iCloud storage
- Apple Support: Apple system status