iCloud Drive Not Syncing Between Your Devices? How to Fix It

A file you saved on your iPhone isn’t appearing on your Mac (or the other way around), or recent changes aren’t showing up.

Why: iCloud Drive only keeps files in sync when it’s turned on under the same Apple Account on every device, with a working connection and enough iCloud storage. When files go missing or stop updating, it’s almost always one of those three things — not lost data.

Fix 1: Turn on iCloud Drive on every device

Each device needs iCloud Drive switched on individually.

• iPhone or iPad: Settings > [your name] > iCloud, then under Saved to iCloud tap Drive and turn on Sync this iPhone (older iOS shows iCloud Drive as a toggle).
• Mac: System Settings > [your name] > iCloud, click Drive, then turn on Sync this Mac.
• Windows: install iCloud for Windows from the Microsoft Store, sign in, click the arrow next to iCloud Drive, enable it, and click Done.

Then confirm every device shows the same Apple Account under Settings > [your name] (Mac: System Settings > [your name]). Mismatched accounts is the number-one cause of “files won’t sync.”

Fix 2: Give it a real connection and time

1. Connect to Wi-Fi and, ideally, power. Large files and first-time syncs can take a while.
2. Open the Files app on iPhone/iPad (Browse > iCloud Drive) or the iCloud Drive folder in Finder on Mac and pull down / wait — a status or spinner means it’s working.
3. As a cross-check, sign in at icloud.com and open Drive. If your file is there, the cloud copy is fine and the other device just needs to finish downloading.

Fix 3: Make sure you’re not out of iCloud storage

If iCloud storage is full, new files can’t upload and syncing stalls silently.

1. Check Settings > [your name] > iCloud > Storage (Mac: System Settings > [your name] > iCloud > Manage).
2. If it’s full, delete old backups, large photos, or files you don’t need — or upgrade to iCloud+.

Fix 4: Windows-only — shorten long file paths

On Windows, a file or folder name that makes the full path too long can block syncing.

• In iCloud for Windows 10 or earlier, one over-long path stops every file in that folder from syncing.
• In iCloud for Windows 10.8 or later, only the offending file is skipped; the rest sync normally.

Rename the file, folder, or subfolders so the whole path is under 256 characters. Also check that third-party security software isn’t blocking iCloud from reaching Apple’s servers.

FAQ

Where do iCloud Drive files actually live? In the Files app on iPhone/iPad, in Finder > iCloud Drive on Mac, in File Explorer on Windows, and at icloud.com. Edit a file in any of these and the change syncs to the rest.

I turned on Desktop & Documents sync and my files moved — is that normal? Yes. On Mac, turning that on moves your Desktop and Documents into iCloud Drive; they’re still there, just under iCloud Drive in Finder.

A file shows a cloud icon and won’t open. That means it’s stored in iCloud but not downloaded locally yet. Tap or double-click it while connected to download it.

Sources: Apple Support — Set up iCloud Drive, Apple Support — If files in Windows won’t sync to iCloud Drive because the path is too long