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 seeLikely check
Waiting to Upload icon on a Mac fileInternet connection and iCloud storage
Out of Space iconiCloud storage is full, so free space
Ineligible iconItem is over the 50 GB per-item limit, or is a library Apple does not upload
Files differ between devicesSame Apple Account and iCloud Drive turned on everywhere
iCloud Data Not Syncing badgeTap the badge in Settings and sign in again
Windows files will not syncFile 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.

  1. On a Mac, open the Apple menu and choose System Settings, then click your name.
  2. Click iCloud, signing in if prompted.
  3. 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.

  1. Open Settings and look for any badges.
  2. Tap or click the badge, then follow the onscreen instructions.
  3. 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.

IconMeaning
In iCloudThe item is only in iCloud and needs an internet connection unless you download it
Waiting to UploadThe item is not yet stored in iCloud
Out of SpaceNot enough iCloud storage is left to store the item
IneligibleThe item cannot be stored in iCloud, usually because it exceeds the 50 GB per-item limit
Keep DownloadedThe item stays on your Mac even when space is needed
Pie chartA transfer is in progress

Show the iCloud status column

  1. Open a Finder window and click iCloud Drive in the sidebar.
  2. Choose View > as List.
  3. 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.

DeviceWhere to look
Mac on macOS Tahoe 26 or laterUnder Favorites in the Finder sidebar
Mac on earlier versionsIn the iCloud section of the Finder sidebar
iPhone or iPadFiles app, then Browse > iCloud Drive, then open Desktop or Documents
iCloud.comSign 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 versionWhat happens
10.8 or laterOnly the problem file does not sync, and the notification shows its path
10 or earlierOne long name stops every file in that folder from syncing
  1. Copy the path name shown in the iCloud notification.
  2. Use File Search in Windows to find the file.
  3. Shorten the file, folder or subfolder names so each is under 256 characters.
  4. 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.

Leave a Reply

Your email address will not be published. Required fields are marked *