iCloud 'Optimize Mac Storage': what it does and what it does not

Part of: System Data on Mac: what is inside and how to reduce it safely (System Data)

Optimize Mac Storage is an iCloud setting that lets macOS keep some files only in the cloud when your disk is getting full. It is a space saver, not a cleaner. It helps in specific cases and does nothing in others, so it pays to know which.

What it does

When it is on, macOS can replace some local files with placeholders and keep the full copy in iCloud. A placeholder shows in Finder like the real file, and the file downloads when you open it. It applies to the things iCloud keeps, such as iCloud Drive files, and macOS chooses what to move based on how recently you used it.

You can find the related settings under your name, then iCloud, in System Settings. Exact labels differ between macOS versions.

What it does not do

• It does not clear caches, logs or local snapshots.
• It does not touch apps, or files that are not in iCloud.
• It does not shrink System Data directly. It can make some space purgeable, which macOS then reports as available. See the purgeable space guide.
• It does not free space on demand. macOS decides when, and usually only when the disk is getting full.

The one thing to know before deleting

A placeholder is a real item in iCloud. If you delete it on your Mac, you delete it from iCloud on every device, and it lands in the Trash. Only empty the Trash when you are sure. The Trash guide explains why the space does not come back until then, and why files held only in iCloud free nothing on your Mac when removed.

How to tell what is local

In Finder, files that live only in iCloud show a cloud icon. Files you open get downloaded and then take space again. In Finder’s list view you can add the Kind or Date columns to find old things, but there is no simple read-only command we tested for this, so we leave it at Finder.

Safe, Risky, Never

Safe

• Leaving Optimize Mac Storage on when you have a reliable internet connection.
• Choosing which folders sync, such as Desktop and Documents, with open eyes.

Risky

• Turning it off on a nearly full Mac. macOS then has to download everything it moved, and the disk may not have the room.
• Working offline with placeholders. You cannot open a file that is not downloaded.

Never

• Deleting placeholders to “save space” on the Mac. It removes the file from iCloud.
• Treating iCloud as your only backup of important files.

What breaks

Offline, you cannot open files that are only in the cloud. If your disk is tight, turning the setting off can fill it. Neither is dangerous, but both are annoying.

When to use something else

If the Mac is full for another reason, such as large old downloads, caches or app data, Optimize Mac Storage will not solve it. The System Data guide covers the other parts.

How it affects the numbers you see

With the setting on, macOS can count the space held by downloadable iCloud files as purgeable. The Storage bar may then show more available space than the physical free space on the disk. That is correct from macOS’s point of view, because it can reclaim that space on demand, but it can surprise you when a tool that counts raw blocks shows a smaller number.

The purgeable space guide explains why these numbers can disagree, and the Trash guide covers the related case of files that live only in iCloud.

Who it helps, and who it does not

It helps most when:

• you have a small disk and a large iCloud plan,
• most of your bulky files are in iCloud Drive,
• you are usually online.

It helps least when:

• your space goes to apps, caches, developer tools or local-only files,
• you often work offline or on slow connections,
• your iCloud storage is itself nearly full.

In the second group, the setting changes little, and the real fix is elsewhere on the disk.

A fair expectation

Think of it as a background helper that makes room only when the disk is under pressure. It is not a way to reach a certain free-space figure on demand. If you want to know how much space it is really saving, compare the size of a folder in Finder’s Get Info window with how much of it is downloaded. We do not give a figure, because it depends entirely on your files.

Look at the whole disk

DiskJoy is our product. Its scan is read-only today: it shows reclaimable space by category and removes nothing, and it treats iCloud-only placeholders as protected. To see what is really using your disk, run the scan.