Symptoms
- Files, photos, or contacts aren't updating across devices
- iCloud Drive shows files as still uploading for a long time
- A sync error or warning icon appears in Finder or System Settings
- Sync worked before but stopped recently
Likely causes
- CommoniCloud storage plan fullOnce storage is full, new content can't sync until you free up space or upgrade.
- CommonA temporary Apple iCloud service outageThis is outside your control but usually resolves within hours.
- PossibleBeing signed out of iCloud or a sign-in token issueA silent sign-out can stop all syncing without an obvious error.
- PossibleA large backlog of files needing to sync after being offlineThis can look like syncing is 'stuck' when it's just working through a queue.
- PossibleA specific app's iCloud sync toggle turned offEach app (Photos, Mail, Contacts) has its own iCloud sync switch.
What to do
- Check System Settings > [your name] > iCloud to confirm you're signed in and see storage usage.
- Check Apple's System Status page (via a phone or another device) to rule out a service-wide outage.
- Free up iCloud storage by deleting unneeded files/photos, or consider upgrading your plan if consistently full.
- Confirm the specific app you're having trouble with (Photos, Drive, Mail) has iCloud sync enabled in System Settings > iCloud.
- Sign out of iCloud and sign back in if sync seems stuck, giving it time to reset (this doesn't delete your iCloud data).
- Check your internet connection, since sync requires a stable connection, especially for large photo or video libraries.
- Restart the Mac to refresh background sync processes.
- Give a large backlog time to work through, especially after being offline for a while or adding many new files at once.
Tools and parts
- None required
When to call a pro
This is almost always resolvable yourself or via Apple Support online chat; in-person repair isn't needed for sync issues.
Safety
Generally low risk
Generally low risk for a careful person. Stop if anything looks different from what this guide describes.