Optimize Mac Storage in iCloud: What It Actually Does

Optimize Mac Storage is the setting that decides whether every iCloud Drive file keeps a full local copy on your Mac, or whether macOS may quietly replace rarely-used files with cloud placeholders when disk space runs low. It's on by default, it's the reason files grow little cloud icons, and it's worth understanding before it makes a decision you didn't expect.

What it does, precisely

With the setting on, macOS stores full copies of your iCloud Drive files locally as long as there's room. When free disk space gets tight, it starts evicting: the local copy of a file is deleted, and what remains is a placeholder — the filename, a cloud-with-arrow icon, and a stub on disk. The real file still exists, complete and safe, in iCloud. Open a placeholder and macOS downloads it on the spot, which takes a beat on Wi-Fi and forever on a plane.

Eviction targets files you haven't opened recently, largest first — old screen recordings and downloads DMGs go before yesterday's spreadsheet. You can't pick which files are eligible; the whole of iCloud Drive (including Desktop & Documents, if you sync them) is in play. With the setting off, macOS downloads and keeps a full local copy of everything in iCloud Drive, and nothing gets evicted — your disk usage equals your iCloud Drive size, permanently.

Where the switch lives

1. Open System Settings → your name → iCloud.
2. Scroll to the bottom of the iCloud pane and find Optimize Mac Storage.
3. Toggle it off to force full local copies, or on to allow eviction. The change is fully reversible — flip it back any time and macOS returns to the previous behaviour.

Turning it off immediately queues a download of every online-only file, so make sure you have the local disk space first: compare your iCloud Drive size (shown in the same pane under Manage) against your free disk in System Settings → General → Storage.

How to see what's been evicted

Evicted files are visible in Finder as cloud icons, but you can audit them all at once from Terminal — placeholders are stored as hidden .icloud stub files:

# list every iCloud Drive file that is currently online-only
find ~/Library/Mobile\ Documents/com~apple~CloudDocs -name "*.icloud"

# just count them
find ~/Library/Mobile\ Documents/com~apple~CloudDocs -name "*.icloud" | wc -l

A count of zero means everything in iCloud Drive has a full local copy right now.

Note the scope: this switch governs iCloud Drive, including Desktop & Documents if you sync those folders. Photos has its own, separately controlled optimize setting inside the Photos app — turning this one off does nothing to your photo library, and vice versa. People flip one and expect the other constantly.

When to turn it off

Leave it on if your Mac has a small SSD and you'd rather never see "disk full" — that's the design case, and for most people it works invisibly. Turn it off if any of these apply:

• You need guaranteed offline access. Travel, flights, spotty internet: a placeholder is useless without a connection.
• You back up with Time Machine or a clone. Backups capture what's on disk — an evicted file isn't there to capture, so your "complete" backup silently excludes it. If iCloud is your only copy of an evicted file, it's a single point of failure.
• You work with big files on deadlines. Discovering a 4 GB project file needs re-downloading at 9 a.m. is not a good morning.

The honest summary: Optimize Mac Storage trades certainty for convenience. Small disk, good internet — keep it on. Anything you can't afford to wait for — keep it off, or keep those files outside iCloud Drive entirely.