Free up storage
iCloud Drive Taking Up Space on Your Mac? Here's Why
iCloud Drive is supposed to save space, not eat it. Here's why your Mac shows iCloud using local storage and how to actually reclaim it.
People expect iCloud Drive to live “in the cloud” — files on Apple’s servers, not your Mac. So when you check Storage and see iCloud Drive using 80GB of local space, it feels wrong.
It’s working as designed. iCloud Drive can either store files locally for fast access or keep them as cloud-only stubs. Which behavior you get depends on settings most people never check. Here’s how it actually works and what to do if you want that local space back.
How iCloud Drive uses local storage
When you save a file to iCloud Drive, two things happen:
- The file uploads to Apple’s servers
- macOS keeps a local copy on your Mac for fast access
The local copy makes iCloud Drive feel instant — files open immediately, no spinning beach ball waiting for downloads. The downside is that it’s still using your disk space.
If your Mac runs low on space, macOS is supposed to automatically purge local copies of files you haven’t opened recently, replacing them with stub files (which show a small cloud icon in Finder). This is “Optimize Mac Storage” for iCloud Drive — usually on by default but worth verifying.
To check: System Settings → [your Apple ID] → iCloud → iCloud Drive → click the small button or arrow → “Optimize Mac Storage.” If it’s off, turn it on.
Manually reclaiming space from iCloud Drive
If you don’t want to wait for macOS to auto-purge, you can manually push files back to the cloud:
- Open Finder
- Navigate to your iCloud Drive (sidebar) or to
~/Library/Mobile Documents/com~apple~CloudDocs/ - Right-click any file or folder → “Remove Download”
That replaces the local copy with a stub. The file is still in iCloud, still appears in Finder, just doesn’t take up local space anymore. Open it later and macOS downloads on demand.
This works for entire folders. Right-click a folder → Remove Download → all contents become stubs.
Useful for: large project folders you’re not actively using, archived stuff, anything that lives in iCloud Drive but doesn’t need to be local right now.
How to find what’s actually local
The iCloud icon in Finder tells you:
- Cloud icon (small cloud with arrow pointing down) — file is stub-only, not downloaded locally
- No icon — file is fully local, taking up disk space
- Cloud icon with progress — currently downloading or uploading
To find your largest local iCloud files:
- Open
~/Library/Mobile Documents/com~apple~CloudDocs/ - Switch to List view
- Sort by Size (you might need Cmd+J → enable “Calculate all sizes”)
The biggest files are your candidates for “Remove Download.” Or use Spotlight: Cmd+F → file size > 100MB → location: iCloud Drive.
When iCloud is actually using more than expected
Sometimes the Storage panel shows iCloud Drive using way more space than you think it should. A few possible reasons:
Desktop and Documents in iCloud. macOS has a feature where your entire Desktop and Documents folders sync to iCloud Drive. Check System Settings → Apple ID → iCloud → iCloud Drive → Drive → “Desktop & Documents Folders.” If this is on, every file on your Desktop and Documents is part of iCloud Drive, with the same local-vs-stub behavior.
Photos counted separately. If you have iCloud Photos enabled, Photos library size is sometimes lumped under iCloud rather than separately. Check the Storage breakdown carefully.
App-specific iCloud containers. Apps like Pages, Numbers, Keynote, Notes use iCloud Drive for their documents. These can add up.
Stuck uploads or downloads. Occasionally a sync gets confused and the same file exists locally and as a stub simultaneously, double-counting space. The fix: pause iCloud Drive (System Settings → Apple ID → iCloud → toggle iCloud Drive off, wait 30 seconds, toggle on).
The “Free Up Space” button most people miss
In Sonoma 14 and Sequoia 15, System Settings → General → Storage shows recommendations. One is “Store in iCloud” with options for Desktop, Documents, Photos, Mail, and Messages. Clicking the small (i) button next to iCloud Drive in the storage breakdown also gives you a manage panel.
That panel lets you sort files by size and delete or remove downloads in bulk. Useful for first-time cleanup.
What if you want OUT of iCloud entirely
If iCloud is using more space than you want and you’d rather just store everything locally:
- System Settings → Apple ID → iCloud → iCloud Drive
- Click the small button or “Sync this Mac”
- Toggle off
When you turn iCloud Drive off, macOS asks if you want to keep a local copy of everything. Say yes if you want to retain all the files; otherwise they get removed locally (cloud copies remain on Apple’s servers).
This isn’t a great long-term answer for most people. Without iCloud Drive, you lose:
- Sync to your phone
- Sync to your other Macs
- Web access at iCloud.com
- The auto-backup of Desktop and Documents
But if you’ve got 50GB of files in iCloud you want fully local with no sync overhead, this is how.
The “Documents in iCloud” trap
The biggest source of unexpected iCloud Drive space usage is the Desktop & Documents Folders feature. When enabled, your entire Desktop and Documents folders count as iCloud Drive content.
To check: System Settings → Apple ID → iCloud → iCloud Drive → “Desktop & Documents Folders.”
If it’s on and you didn’t expect it, decide:
- Leave on, free up space: select files in your Desktop and Documents that you don’t need locally → right-click → Remove Download. They stay in iCloud, just become stubs.
- Turn off: macOS will ask whether to keep your files local (recommended) or to leave them only in iCloud. The latter means you’ll need to manually re-download anything you want offline.
Most people who turn this on do so accidentally during a macOS setup wizard. If your Desktop is suddenly full of cloud-icon files you can’t open offline, that’s why.
App-specific iCloud containers
Many apps store data in iCloud Drive in their own containers, separate from the main Drive folder. They’re at:
~/Library/Mobile Documents/iCloud~<bundle id>/
Examples:
- iCloud
comapple~CloudDocs (the main iCloud Drive) - iCloud
comapple~Pages (Pages documents) - iCloud
comapple~Numbers (Numbers files) - iCloud
comapple~mail (Mail attachments) - iCloud
comthirdparty~app (any third-party app)
Each of these can have local copies eating space. Same trick — right-click in Finder → Remove Download.
If you no longer use a specific app, you can delete its container entirely. Quit the app, then in Finder remove the container folder. The cloud copy stays on Apple’s servers; only the local copy is removed.
A reasonable iCloud Drive setup
For most people, the right configuration is:
- iCloud Drive on
- Optimize Mac Storage on
- Desktop & Documents Folders on (or off, your call)
- Manually “Remove Download” on large folders you don’t need locally
- Quarterly check on what’s local with a sort-by-size sweep
This keeps iCloud Drive useful — sync, backup, multi-device access — without it consuming your whole boot drive.
The honest take: iCloud Drive’s space behavior is opaque on purpose. Apple wants files to feel instant, which means caching aggressively. The “Remove Download” option is the manual override, and it works well — it’s just buried two right-clicks deep, which is why most people never find it. Once you know about it, reclaiming 20-50GB of iCloud Drive local space takes about ten minutes.