Optimize Mac Storage

On this page 7

Optimize Mac Storage is a macOS setting that lets the system keep files and photos in iCloud while removing their local copies when the startup disk runs short of space, downloading them again automatically when they are opened. In the field of macOS storage & backup, it is a space management feature, not a backup: it changes where the only complete copy of a file lives, which matters for anyone who relies on Time Machine or works offline.

The name appears in two places. In iCloud Drive settings, it controls whether documents are kept locally or only in the cloud; in the Photos app, it replaces full-resolution originals on the Mac with smaller device-optimized versions. Both follow the same principle: the cloud holds the authoritative copy, and the Mac holds whatever fits.

How Optimize Mac Storage evicts and restores files

Optimize Mac Storage works by turning local files into dataless placeholders once their content is safely uploaded to iCloud. The file keeps its name, icon, size information and metadata in the Finder, but its data blocks are released from the APFS volume. When an app or the user opens the file, macOS downloads the content on demand and the file becomes a normal local file again.

Since macOS Monterey 12.3, iCloud Drive runs on Apple’s File Provider framework, the same system that third-party cloud services use. The framework tracks each item’s state and decides which items to evict. Eviction is driven by free-space pressure and recency of use: files that have not been opened for a long time are the first candidates, and recently used files usually stay local.

Space held by evictable cloud files is often reported as purgeable space. It counts as available because macOS can reclaim it without asking, but it is not empty until the system actually removes the local data. The table below shows the states an iCloud Drive item can be in.

Item stateWhat is stored locallyFinder indicationOpens offline
Fully downloadedMetadata and all contentNo cloud iconYes
Evicted placeholderMetadata onlyCloud icon with arrowNo
DownloadingPartial contentProgress indicatorNot yet
Waiting to uploadAll content, cloud copy pendingDotted cloud or progressYes
Kept downloadedAll content, pinned locallyNo cloud iconYes
States of an iCloud Drive item under Optimize Mac Storage

Where the setting appears in macOS

The same label controls two separate mechanisms, and enabling one does not enable the other. Apple also groups related space-saving options under Storage recommendations in System Settings, which can switch these features on in one step.

LocationWhat it optimizesLocal resultCloud requirement
iCloud Drive settingsDocuments, Desktop and other iCloud Drive filesOld files become placeholdersEnough iCloud storage for all files
Photos settings, iCloud tabPhoto and video librarySmaller previews replace originalsiCloud Photos enabled
Storage recommendationsSeveral categories at onceTurns on cloud storage and cleanupDepends on chosen option
Apple TV app storagePurchased movies and TV episodesWatched downloads removedPurchases stay redownloadable
Places where Optimize Mac Storage or related options are configured

In the Photos app, the optimized library keeps thumbnails and screen-sized versions locally and stores full-resolution originals only in iCloud. Exporting an original, editing in a third-party app or viewing at full zoom triggers a download. A library of several hundred gigabytes can shrink to a fraction of that size, although the exact ratio depends on how many items macOS chooses to keep in full quality.

Optimize Mac Storage is often confused with backup and snapshot features because all of them affect disk usage. The difference lies in who holds the only full copy and whether older versions are preserved.

FeatureMain purposeKeeps a second copyProtects against deletion
Optimize Mac StorageFree local disk spaceNo, cloud holds the contentOnly within iCloud’s 30-day recovery window
Time MachineVersioned backupYes, on another diskYes, with hourly history
APFS snapshotPoint-in-time volume stateSame disk onlyPartially, until snapshot expires
Purgeable spaceReclaimable cache and cloud dataNot applicableNo
System Data categoryReporting of caches, logs, snapshotsNot applicableNo
Optimize Mac Storage compared with neighboring macOS features

The key warning is that iCloud Drive is a sync service. A file deleted on one device is deleted everywhere, and once a file is evicted, a Time Machine backup made afterwards may contain only the placeholder rather than the content. Practitioners therefore treat Optimize Mac Storage and Time Machine as complementary, not interchangeable.

Choosing when to enable it

Optimize Mac Storage suits Macs with small internal SSDs and owners with a reliable internet connection and sufficient iCloud capacity. It is less suitable for people who travel without connectivity, edit large media projects or need a complete local archive. The decision table summarizes typical situations.

SituationRecommendationReason
256 GB Mac, large photo libraryEnable in PhotosOriginals stay safe in iCloud Photos
Frequent offline travelDisable, or keep folders downloadedPlaceholders cannot open without a connection
Video editing on internal diskDisable for project foldersLarge downloads stall editing apps
Family Mac with modest documentsEnable in iCloud DriveLow-risk savings with little effort
Archive or legal recordsDisable and back up locallyA complete local copy is required
Decision guide for Optimize Mac Storage

Recent versions of macOS let users mark individual files or folders with Keep Downloaded in the Finder, which exempts them from eviction. The opposite command, Remove Download, evicts an item manually. Combining these controls gives folder-level precision without turning the feature off entirely.

Limitations and common mistakes

The feature is reliable when iCloud has room for everything, but several failure modes appear in support practice. Most of them come from misunderstanding that local free space is borrowed from the cloud.

  • Insufficient iCloud plan: if the account is full, uploads stop and nothing can be evicted, so the Mac never gains space.
  • Turning the feature off on a nearly full disk: macOS must download every evicted file, which can fail or fill the startup disk.
  • Signing out of iCloud: the system offers to keep a copy, but placeholders that were never downloaded are not saved locally.
  • Slow or metered connections: opening an evicted file can take minutes and consume mobile data.
  • Apps that scan whole folders: indexing or backup tools may force mass downloads of placeholders.
  • Assuming it is a backup: deletions and accidental overwrites sync to every device.

Before disabling the setting or migrating to a new Mac, it is prudent to confirm free space exceeds the size of iCloud Drive and to let downloads finish fully. Checking the Storage panel and the Finder status column prevents half-downloaded libraries that look complete but are not.

Explained without jargon

Optimize Mac Storage works like a storage unit for your files. Things you use every day stay at home on the Mac, while things you rarely touch are kept in Apple’s cloud. Their names still appear in your folders, so you can find them as usual.

When you open one of those stored files, the Mac quietly fetches it from the internet. The catch is simple: without an internet connection, the stored items cannot be opened, and the cloud copy is the only full copy, so a separate backup is still wise.

A typical use case

A freelance designer uses a MacBook Air with a 256 GB internal SSD. After three years, the Desktop and Documents folders hold about 140 GB of client archives, and the Photos library has grown to 110 GB. macOS shows less than 10 GB free, and design apps begin warning about scratch space.

The designer upgrades to a 2 TB iCloud plan, enables Desktop and Documents syncing and turns on Optimize Mac Storage in both iCloud Drive and Photos. Within a day of uploading, old client folders become placeholders and the Photos library keeps only optimized previews. Free space rises to roughly 150 GB, while current projects are marked Keep Downloaded so they open instantly.

Because the cloud now holds the only complete copy of older work, the designer also connects an external drive for weekly Time Machine backups and downloads critical archives before long flights. The outcome is a usable laptop without buying new hardware and no loss of access to older files.