iCloud Drive

On this page 7

iCloud Drive is Apple’s cloud file storage and synchronization service, built into the macOS Finder, that keeps documents and folders identical across a user’s Mac, iPhone, iPad and the web. Files saved in iCloud Drive are uploaded to Apple’s servers and propagated to every device signed in with the same Apple Account, while apps can store their own documents in dedicated containers.

Among macOS apps & services, iCloud Drive acts as the shared file layer that features such as Desktop and Documents sync, Handoff of documents and app document libraries rely on. It was introduced in 2014 with OS X Yosemite and iOS 8 and uses the storage quota of the user’s iCloud account: 5 GB free, with larger quotas available through paid iCloud+ plans.

How iCloud Drive synchronizes files

iCloud Drive synchronizes by keeping a local file tree on each Mac and reconciling it with the copy stored on Apple’s servers. On current macOS versions the service is integrated through the File Provider framework, and background processes upload changes, download new versions and resolve conflicts without the user opening a separate app.

On disk, the files live in a hidden library folder of the user account, but the Finder presents them in the iCloud Drive sidebar location. Each file has a sync state that the Finder shows with small status icons, so the user can see whether a file is local, in the cloud only or still uploading.

StateWhat it meansDisk space used
DownloadedFull copy stored on the MacFull file size
Cloud onlyPlaceholder; content fetched on openAlmost none
UploadingLocal changes not yet on the serverFull file size
Keep downloadedPinned to stay local permanentlyFull file size
ConflictTwo devices changed the same fileBoth versions kept
File states shown in the Finder

When two devices edit the same file while offline, iCloud Drive does not merge the changes. It keeps both versions and asks the user to choose, which is safe but can leave duplicate files if conflicts are ignored.

Key features and settings

Most iCloud Drive behavior on a Mac is controlled in System Settings under the Apple Account and iCloud section. The table lists the settings that matter most in practice.

SettingEffectTypical use
Desktop and Documents FoldersMoves both folders into iCloud Drive and syncs themSame desktop on several Macs
Optimize Mac StorageRemoves local copies of older files when space runs lowLaptops with small SSDs
Shared foldersLets others view or edit a folderFamily or small team collaboration
Advanced Data ProtectionEnables end-to-end encryption of iCloud DriveHigher privacy requirements
Per-app accessAllows apps to store documents in iCloudPages, Numbers, third-party editors
Important iCloud Drive options on macOS

Advanced Data Protection, available since macOS Ventura 13.1, changes the security model significantly. With standard protection, data is encrypted in transit and on Apple’s servers but Apple holds the keys, which allows account recovery. With Advanced Data Protection, the keys exist only on the user’s trusted devices, so a lost recovery method can mean permanently lost data.

iCloud Drive is a sync service, not a backup, and it is easily confused with other Apple storage features. The comparison shows how they divide the work.

ServiceMain purposeProtects against deletion
iCloud DriveSync files across devicesOnly for about 30 days via Recently Deleted
iCloud PhotosSync the photo libraryLimited, 30-day recovery album
Time MachineVersioned local backup of the MacYes, hourly and historical versions
iCloud BackupBackup of iPhone and iPadYes, for mobile devices
AirDropOne-time transfer between nearby devicesNo, nothing is stored
iCloud Drive and neighboring storage features

The critical point is that a deletion or corruption propagates to every device. A file accidentally deleted on an iPad disappears from the Mac as well. Deleted files can usually be restored for about 30 days, but long-term protection still requires Time Machine or another backup.

Storage plans and practical sizing

iCloud Drive shares one quota with all iCloud data, including photos, device backups, messages and mail. Users often run out of space not because of documents but because of photo libraries and backups.

TierTypical userComment
5 GB freeLight document use onlyFills quickly when backups are on
50 GBOne person with modest photo libraryCommon entry plan
200 GBOne heavy user or a small familyCan be shared with Family Sharing
2 TB and aboveLarge photo and video librariesHigher tiers of 6 TB and 12 TB exist
Typical iCloud storage tiers

When the quota is full, uploads stop silently in the background until space is freed or the plan is upgraded. Files edited during that time exist only locally, which is a frequent and unnoticed cause of missing documents on other devices.

Common mistakes and limitations

  • Treating sync as backup: without Time Machine or another backup, ransomware or accidental overwrites reach every device.
  • Storing unsuitable data: virtual machine images, large media libraries and software development repositories with many small files sync slowly and can cause conflicts.
  • Expecting offline access to cloud-only files: with Optimize Mac Storage, a file may not be on the Mac when there is no internet connection, unless it is marked Keep Downloaded.
  • Losing recovery options under Advanced Data Protection: without a recovery key or recovery contact, Apple cannot restore access.
  • Excluding folders: a folder name ending in .nosync is skipped by sync, which is a workaround for build directories and caches.

Explained without jargon

iCloud Drive is a folder that lives in the cloud but shows up on all your Apple devices. Put a file in it on your Mac, and a moment later you can open it on your iPhone or iPad.

It works like a shared notebook kept in a safe place, where every copy updates when one changes. The key takeaway is that it keeps files in sync, not safely backed up. If you delete a file in one place, it disappears everywhere.

A typical use case

A university lecturer uses a desktop iMac in her office and a MacBook Air with 256 GB of storage at home. She turns on Desktop and Documents Folders in iCloud Drive and subscribes to a 200 GB iCloud+ plan.

Lecture slides she edits at the office are on the laptop by the time she gets home, and Optimize Mac Storage keeps older course archives as cloud-only files, saving about 60 GB on the laptop. She marks the current semester folder as Keep Downloaded so it is available on trains without internet. Because sync is not backup, she also runs Time Machine to an external drive on both Macs, which later lets her recover a slide deck she overwrote by mistake two months earlier.