Home/Troubleshooting guide
Mac cloud-file guide

iCloud Drive not syncing on Mac? Check the file location first

Short answer: check Apple's System Status, confirm iCloud Drive and Sync this Mac are on, then inspect one affected item in Finder and on iCloud.com. Preserve the newest copy before signing out, turning off iCloud Drive, or changing Desktop and Documents.

Unbranded silver laptop showing two blank file tiles and an abstract blue sync progress ring
Protect the newest copy first. For one affected file, record whether it exists in Finder, on iCloud.com, and on another signed-in device. Note the modified date and file size in each place. Download or copy the newest verified version to a separate local or external folder before changing account or sync settings.
Do not reset iCloud Drive blindly. Do not delete CloudDocs data, kill undocumented sync processes, edit sync databases, empty Recently Deleted, or sign out before you know where the current file exists. On a managed Mac, stop before account, profile, storage, or policy changes.

Find the affected scope

Start with one file you can identify without exposing private content. Check whether the problem affects that file, its whole folder, every item in iCloud Drive, or only this Mac. Then check the same Apple Account on iCloud.com or another signed-in device.

What you findLikely scopeNext check
The current file is on iCloud.com but missing or old in FinderThe cloud copy exists. This Mac may have a download or local sync problem.Read Finder's iCloud Status and check local free space.
The current file is in Finder but missing or old on iCloud.comThe Mac may not have uploaded it.Read the item's status, iCloud storage, and account state.
The file differs across devicesYou have a version conflict, not proof that one device has the right copy.Preserve each version before choosing one.
The file is missing everywhereDo not treat this as an ordinary sync delay.Check Recently Deleted and contact Apple before further changes.

Apple showed iCloud Drive as available during this review on October 14, 2026. That current status does not rule out an earlier interruption, an intermittent problem, or an issue limited to one account or Mac.

Check the Apple Account and Sync this Mac

Open System Settings, select your name, choose iCloud, then Drive. Confirm that the Mac uses the expected Apple Account and that Sync this Mac is on. Do not toggle it off just to see what happens.

Check both iCloud storage and local Mac storage. A full iCloud plan can block uploads. Low local storage can also prevent a cloud-only file from downloading. If macOS itself failed to update because of storage or installer trouble, use the macOS update guide instead of mixing that repair with iCloud changes.

Read Finder's iCloud Status

Open Finder and select iCloud Drive. Choose list view, open View Options, and turn on iCloud Status. Read the state for one affected item before judging the whole account.

Finder statusWhat Apple saysSafe next step
In iCloudThe item is stored in iCloud and is not downloaded to this Mac.Use Download Now if you need a local copy and have enough space.
Downloaded or Keep DownloadedThe item has a current local copy. Keep Downloaded tells macOS to retain it locally.Open the file and compare it with iCloud.com.
Waiting to UploadThe item is not yet stored in iCloud.Keep the local copy, then check service, network, account, and storage state.
Out of SpaceiCloud does not have enough storage for the item.Review iCloud storage without deleting the only file copy.
IneligibleThe item cannot be stored in iCloud. Apple says this often means a file or folder exceeds the 50 GB limit.Confirm the item size and keep it outside iCloud Drive if needed.

Compare Finder with iCloud.com

Open iCloud Drive on iCloud.com and find the same item. Compare the name, modified date, file size, and content where it is safe to do so. A file visible online but absent on the Mac needs a download check. A file present only on the Mac needs an upload check.

If iCloud.com has the newest verified copy, download it to a separate local folder. If Finder has the newest copy, copy it outside iCloud Drive or to an external drive. Do not overwrite the other version until you have preserved both.

Use the status to choose the next step

For one small, non-sensitive test file, record whether it uploads from the Mac and appears on iCloud.com. Then make a different small test file on iCloud.com and see whether it appears on the Mac. This separates upload trouble from download trouble without moving a whole folder.

If every file waits, check the service, internet connection, Apple Account, iCloud storage, and local storage. If only one item is stuck, check its size, name, permissions, and containing folder. If the result remains unclear, preserve the copies and give Apple Support the exact status, timestamps, device list, and storage values.

A Windows OneDrive problem has different account, unlink, and reset boundaries. Use the OneDrive guide for that service.

Protect Desktop and Documents

Before changing Desktop and Documents, check whether another cloud provider manages those folders. Apple says another provider should not manage the same folders at the same time.

Deleting a file on one signed-in device deletes it on the other signed-in devices. Turning off iCloud Drive or signing out can also change where local copies appear. Preserve the newest files first, then follow Apple's current prompts for keeping a local copy. Do not assume a setting change is reversible when the only current file exists in one place.

Where OmniMend fits

OmniMend's Mac app supports local diagnostics on Apple Silicon Macs. It can help organize local system, storage, and diagnostic clues on a supported Mac. It does not change iCloud settings, repair Apple's service, recover a missing cloud file, or support Intel Macs.

The guide remains useful without OmniMend. If you want a local evidence record after preserving the newest files, check the current Mac requirements before installing anything.

Editorial sources

Checked October 14, 2026 against Apple's current System Status, iCloud Drive setup, Finder iCloud Status guide, Desktop and Documents guide, and iCloud.com upload and download guide. Apple supplies the setting paths, file states, storage and eligibility meanings, web comparison, folder-provider warning, and synced-deletion boundary. The review also checked current search results and recent user reports for version-conflict and stalled-sync language. Those reports do not prove a cause or safe reset. OmniMend added the scope table, copy-preservation order, internal routes, managed-device stop, and product boundary. OmniMend is not affiliated with Apple.

Find the newest copy.
Then preserve it.

Keep the Finder status, iCloud.com result, storage values, and file timestamps for support.

Check OmniMend for Mac