How To Fix iCloud Drive Files Not Syncing Or Uploading (2026)
iCloud Drive files that will not upload, or that do not appear on your other devices, usually point to a switch, a storage limit or a file name problem.
Apple documents the status icons, setup steps and a Windows path limit that explain most cases.
The sections below start with the quickest checks and move to the specific ones.
Quick answer: what the symptom points to
| What you see | Likely check |
|---|---|
| Waiting to Upload icon on a Mac file | Internet connection and iCloud storage |
| Out of Space icon | iCloud storage is full, so free space |
| Ineligible icon | Item is over the 50 GB per-item limit, or is a library Apple does not upload |
| Files differ between devices | Same Apple Account and iCloud Drive turned on everywhere |
| iCloud Data Not Syncing badge | Tap the badge in Settings and sign in again |
| Windows files will not sync | File or folder name 256 characters or longer |
Start with the account and update checks
Apple says to update each device to the latest operating system and sign in to iCloud with the same Apple Account on all of them.
Files only sync between devices that share that account, so a second Apple Account on one device explains many missing files.
Then confirm iCloud Drive is actually on for the device you are using.
Turn iCloud Drive on
On an iPhone or iPad, open Settings, tap your name, tap iCloud, and turn on sync for the Drive entry under Saved to iCloud or Apps Using iCloud.
Your files then appear in the Files app.
- On a Mac, open the Apple menu and choose System Settings, then click your name.
- Click iCloud, signing in if prompted.
- Under Saved to iCloud, click Drive, then click Sync this Mac.
Fix the iCloud Data Not Syncing message
Apple says that when iCloud data is not syncing, you may see a badge in Settings.
- Open Settings and look for any badges.
- Tap or click the badge, then follow the onscreen instructions.
- If prompted, authenticate your account.
If the message still appears after you authenticate, Apple tells you to contact Apple Support.
Read the status icons on a Mac
Apple’s Mac guide lists icons that show where each file stands.
| Icon | Meaning |
|---|---|
| In iCloud | The item is only in iCloud and needs an internet connection unless you download it |
| Waiting to Upload | The item is not yet stored in iCloud |
| Out of Space | Not enough iCloud storage is left to store the item |
| Ineligible | The item cannot be stored in iCloud, usually because it exceeds the 50 GB per-item limit |
| Keep Downloaded | The item stays on your Mac even when space is needed |
| Pie chart | A transfer is in progress |
Show the iCloud status column
- Open a Finder window and click iCloud Drive in the sidebar.
- Choose View > as List.
- Choose View > Show View Options, then select iCloud Status.
Apple notes that status icons still appear beside most file names even without this column.
Open a file that is only in iCloud
For an item that is only in iCloud, connect to the internet, or Control-click the file and choose Download Now.
Apple’s page does not give a fix for a file stuck on Waiting to Upload, so the connection and storage checks matter most.
Free up iCloud storage
The Out of Space icon means there is not enough iCloud storage left, and a similar icon beside iCloud Drive in the sidebar means your storage is full.
Free space or choose a different plan, using our guide to full iCloud storage, our iCloud backup storage guide and our guide to changing an iCloud+ plan.
Desktop and Documents sync
If you use Desktop & Documents Folders, Apple says to confirm Sync this Mac is on and that Desktop & Documents Folders is turned on.
If another cloud service currently manages those folders, Apple says to turn that feature off first.
Apple says files sync whenever a device connects to the internet, and how fast they appear on other devices depends on your internet speed.
iMovie, Photos and Aperture library files are not uploaded to iCloud Drive and show as Ineligible.
Where to look for synced files
Apple lists a different place to find Desktop and Documents files on each device.
| Device | Where to look |
|---|---|
| Mac on macOS Tahoe 26 or later | Under Favorites in the Finder sidebar |
| Mac on earlier versions | In the iCloud section of the Finder sidebar |
| iPhone or iPad | Files app, then Browse > iCloud Drive, then open Desktop or Documents |
| iCloud.com | Sign in, go to iCloud Drive and open the folder |
If a file is missing on one device, check the same folder on iCloud.com to see whether it uploaded at all.
On iCloud.com, Apple says to download a file to edit it and upload it back so the latest version syncs, while Pages, Numbers and Keynote files can be edited on the web and save directly to iCloud Drive.
A second Mac shows a different folder
Apple says each additional Mac’s Desktop appears inside iCloud Drive in a folder named after that Mac.
Files from two Macs do not merge, so your files are not missing when you see two folders.
Files will not sync on a Windows PC
For iCloud for Windows, Apple says a file or folder name that is too long can stop a file from syncing.
| iCloud for Windows version | What happens |
|---|---|
| 10.8 or later | Only the problem file does not sync, and the notification shows its path |
| 10 or earlier | One long name stops every file in that folder from syncing |
- Copy the path name shown in the iCloud notification.
- Use File Search in Windows to find the file.
- Shorten the file, folder or subfolder names so each is under 256 characters.
- Update to the latest iCloud for Windows if you use version 10 or earlier.
Apple also warns that third-party apps using renamed files may not update to the new names.
Deleted files and recovery
Apple says deleting a file on one device removes it from every device signed in to the same Apple Account.
Deleted files stay in Recently Deleted for 30 days in the Files app or on iCloud.com, and are permanently removed after that.
Other iCloud items that will not sync
If photos or notes are the problem rather than files, read our iCloud Photos sync guide and our iCloud Notes sync guide.
Sources: Set up iCloud Drive, If you get an iCloud Data Not Syncing message, Add your Desktop and Documents files to iCloud Drive and If files in Windows won’t sync to iCloud Drive.