SiftMac
Guide · Updated 21 November 2026

iCloud’s Optimize Mac Storage: what it frees, and what it doesn’t

By Mohit Nippanikar, who makes SiftMac

The short answer
On this page
  1. Four settings with similar names
  2. When the space actually comes back
  3. See what’s on the Mac and what’s only in iCloud
  4. Desktop & Documents: before you turn it on
  5. What it costs
  6. Questions

1. Four settings with similar names

macOS has several switches that sound alike and free different things:

SettingWhereWhat it frees
Optimize Mac Storage for iCloud DriveSystem Settings › your name › iCloud › DriveOlder 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 PhotosPhotos › Settings › iCloudFull-size photos and videos, replaced by smaller versions when space is limited. The originals stay in iCloud.
Desktop & Documents FoldersSystem Settings › your name › iCloud › DriveNothing by itself: it moves those two folders into iCloud Drive, where the first setting can then free them.
Optimize StorageSystem Settings › General › StorageFilms 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

5. What it costs

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