iCloud’s Optimize Mac Storage: what it frees, and what it doesn’t
- It frees space only when your Mac needs it. With Optimize Mac Storage on, older iCloud Drive files and full-size photos stay in iCloud, and the Mac removes its local copies as the disk fills, not the moment you switch it on.
- What it costs you: files that aren’t on the Mac need an internet connection to open, and everything has to fit in your iCloud plan.
- What it never touches: apps, System Data, iPhone backups, developer and AI files, and anything outside iCloud Drive and the Photos library.
1. Four settings with similar names
macOS has several switches that sound alike and free different things:
| Setting | Where | What it frees |
|---|---|---|
| Optimize Mac Storage for iCloud Drive | System Settings › your name › iCloud › Drive | Older documents in iCloud Drive, when the Mac needs space. If it doesn’t, Apple says the full contents stay on the Mac. |
| Optimize Mac Storage for Photos | Photos › Settings › iCloud | Full-size photos and videos, replaced by smaller versions when space is limited. The originals stay in iCloud. |
| Desktop & Documents Folders | System Settings › your name › iCloud › Drive | Nothing by itself: it moves those two folders into iCloud Drive, where the first setting can then free them. |
| Optimize Storage | System Settings › General › Storage | Films and TV shows you’ve watched in the TV app, and all but recent email attachments, when space is needed. |
Storage settings also offers Store in iCloud, which turns on the iCloud options together: Desktop and Documents in iCloud Drive, photos in iCloud Photos, and messages and attachments in iCloud.
2. When the space actually comes back
Optimizing isn’t a cleanup that runs once. Apple describes it as working when space is needed: the Mac keeps everything it can, and lets go of older files as the disk fills. Until then, the local copies count as purgeable space, which Finder shows as available. What purgeable space means.
So turning it on rarely changes the storage bar that day. To free iCloud Drive space now, do it yourself: in Finder, Control-click a file or folder in iCloud Drive and choose Remove Download. It stays in iCloud and on your other devices, and downloads again when you open it.
Keep Downloaded, in the same menu, does the opposite: it keeps a file or folder on the Mac even when space runs low. Use it for things you need offline.
3. See what’s on the Mac and what’s only in iCloud
In Finder, click iCloud Drive, switch to List view, and choose View › Show View Options, then tick iCloud Status. A cloud icon marks items that are only in iCloud; downloaded items show no icon.
Terminal can total it. The first line is what iCloud Drive takes on this Mac now; the second is how big it would be with everything downloaded:
du -sh ~/Library/Mobile\ Documents/com~apple~CloudDocs
du -shA ~/Library/Mobile\ Documents/com~apple~CloudDocs
For Photos, the Photos line in Storage settings shows what the library takes on the Mac.
4. Desktop & Documents: before you turn it on
- Everything in both folders moves to iCloud, and Apple notes it uses your iCloud storage. New files you save there go to iCloud too.
- Turn off other syncing first. Apple says another app or cloud service syncing those folders can interfere with iCloud Drive.
- Turning it off doesn’t bring the files back. Apple says they stay in iCloud Drive, and macOS makes new Desktop and Documents folders in your home folder. Moving files out of iCloud Drive into them also removes them from iCloud on your other devices.
- Keep busy work elsewhere. Code projects, virtual machines and video projects are big and change constantly. In Desktop or Documents, every change uploads, and a file that’s been removed from the Mac has to download again before its app can open it.
5. What it costs
- Offline access. A file that’s only in iCloud needs a download before it opens, so without a connection it won’t open at all, unless you set it to Keep Downloaded.
- iCloud storage. Your plan has to hold everything you keep there, Photos library included. When iCloud is full, Apple says new documents wait on the Mac and upload once space is available.
- Deletions sync. Delete a file in iCloud Drive, or a photo with iCloud Photos on, and it goes from your other devices too. Syncing isn’t a backup, so keep one, such as Time Machine.
- It only covers iCloud. Apps, caches, System Data, iPhone backups and every other folder stay on the Mac whatever you choose. See where the rest of your space goes.
Questions
Does Optimize Mac Storage delete my files?
No. Files stay in iCloud and on your other devices; only the copy on this Mac goes, and it downloads again when you open it.
I turned on Optimize Mac Storage. Why didn’t I get space back?
It works only when the Mac needs space, and older files go first. To free space now, use Remove Download on iCloud Drive items you don’t need on this Mac.
Can I turn it on for Photos but not for iCloud Drive?
Yes. They’re separate settings: one in Photos › Settings › iCloud, the other in System Settings › your name › iCloud › Drive.
What happens if I turn off Desktop & Documents Folders?
Your files stay in iCloud Drive, and macOS creates new, empty Desktop and Documents folders on the Mac. To have the files on the Mac again, move them back from iCloud Drive, knowing that this removes them from iCloud on your other devices.
How SiftMac handles it. SiftMac never downloads iCloud files to look at them: its duplicate, large-file and photo scans skip files that are only in iCloud, and its space map marks iCloud Drive as private rather than measuring it. Its System Data view shows the space macOS can free by itself, local copies of iCloud files included, and leaves that to macOS.
Download SiftMac · scanning is free, and so is your first 2 GB of cleaning · See how it works