Optimize Mac Storage usually isn't broken. When people say Optimize Mac Storage is not working, the Mac is most often doing what Apple designed: it stores iCloud Drive documents in iCloud only "when more space is needed", and "if space is not needed, the full contents of iCloud Drive remain on your Mac".
The rest of the time, something specific is holding files on the disk. The checks below find which one, using Finder's own iCloud status column.
1. Turn on the iCloud Status column first
Most fixes start with knowing what state each file is in. In Finder, open iCloud Drive, choose View › as List, then View › Show View Options, and select iCloud Status.
Each item now shows an icon. Apple's list:
- In iCloud: only in iCloud, not taking space on this Mac
- Keep Downloaded: kept on the Mac even when space is needed
- Waiting to Upload: not yet stored in iCloud
- Out of Space: can't be stored because your iCloud storage is full
- Ineligible: usually over the 50 GB limit for one file or folder
- No icon: downloaded, and on your Mac
For a quick overall check, hold the pointer over iCloud Drive in the Finder sidebar and click the status icon.
2. Check that the two switches are on
Choose Apple menu › System Settings, click your name, click iCloud, then Drive. Make sure "Sync this Mac" is on, then turn on Optimize Mac Storage.
If Sync this Mac is off, iCloud Drive isn't running on this Mac at all, so nothing gets sent back.
3. Your Mac simply has enough free space
This is the most common cause. Apple doesn't say how full the disk must be before files go back to iCloud, only that it happens "when more space is needed". Apple also says "recent files and optimized versions of your photos are always on your Mac".
So a Mac with plenty of room keeps everything. To free space now, Control-click a file or folder in iCloud Drive and choose Remove Download. The file stays in iCloud and comes back when you open it.
When you want files off the Mac by default
That last point is the real limit. iCloud Drive is built to keep files on your devices and step in only when the disk is nearly full. If you want the opposite, files that live in the cloud and stay off your disk until you use them, you need a drive built that way.
That's why we made CloudRoomy, a cloud drive in Finder whose files take zero bytes on disk. Opening a file fetches only the parts the app reads, and recently opened files stay within a limit you set, from 1 to 50 GB. Files are encrypted on your Mac with a key only you hold.
It runs only on Apple silicon Macs with macOS 26.2 or later, has no iPhone app, and costs more per terabyte than iCloud+. For the full trade-off, read CloudRoomy compared with iCloud Drive. If tip 3 is your cause, this is the fix.
4. Look for Keep Downloaded folders
Keep Downloaded tells the Mac to keep chosen items "downloaded on your Mac no matter what". A big folder marked this way years ago can hold a lot of space.
In the iCloud Status column, look for the Keep Downloaded icon. Control-click the item and choose Keep Downloaded again to clear the tick, then choose Remove Download if you want the space at once.
5. Files waiting to upload can't leave
A file can only go back to iCloud once iCloud has a copy. Items showing Waiting to Upload are still only on your Mac. Let them finish on a steady connection before you expect any space back.
6. Your iCloud storage is full
If items show Out of Space, iCloud has no room for them. Apple says a document that can't be saved to iCloud Drive "stays on your Mac, and is uploaded to iCloud Drive when space becomes available". So it can't be removed from the Mac either.
Free space in iCloud, or move to a bigger plan. In the US, iCloud+ costs $0.99 a month for 50 GB, $2.99 for 200 GB and $9.99 for 2 TB. The free tier is 5 GB.
7. A file or folder is too big for iCloud
Items marked Ineligible usually exceed Apple's 50 GB limit for a single file or folder. They stay on the Mac. Split the folder, or keep that one somewhere else, such as an external drive.
8. Another sync app is getting in the way
Apple warns that "syncing by other third-party apps or cloud services can interfere with or stop the updating performed by iCloud Drive". If you sync the same folders with Dropbox, Google Drive or a backup tool, pause it and check again.
9. Photos has its own Optimize Mac Storage
The iCloud Drive switch doesn't cover your photo library. In Photos, choose Photos › Settings, click iCloud, select iCloud Photos, then select Optimize Mac Storage. Photos then keeps smaller versions on your Mac "when storage space is limited" and the originals in iCloud.
For the background on why files keep coming back after you open them, read our guide on why iCloud Drive keeps downloading files.
Optimize Mac Storage checklist
| Icon or symptom | What it means | What to do |
|---|---|---|
| No icon | Downloaded, on your Mac | Remove Download, or wait until space is needed |
| Keep Downloaded | Pinned to the Mac | Untick Keep Downloaded |
| Waiting to Upload | Not in iCloud yet | Let it upload |
| Out of Space | iCloud is full | Free iCloud space or upgrade |
| Ineligible | Over 50 GB | Split it or store it elsewhere |
| Photos still huge | Separate setting | Turn on Optimize in Photos |
Save or screenshot this table.
Which fix to start with
Start with tip 1, the status column, because it tells you which of the others applies. If you see no icons at all, tip 3 is your answer. If you see Out of Space, go straight to tip 6.
Questions people ask
Why is Optimize Mac Storage not freeing up space?
Usually because your Mac doesn't need the space yet. Apple says iCloud Drive files go back to iCloud "when more space is needed", and recent files always stay.
How do I remove downloaded iCloud Drive files from my Mac?
In Finder, Control-click the file or folder in iCloud Drive and choose Remove Download. The copy on this Mac goes, and the file stays in iCloud and on your other devices.
Why does iCloud Drive say Waiting to Upload?
The file isn't stored in iCloud yet, so it can't leave your Mac. Check your connection, and check your iCloud storage isn't full.
Does Optimize Mac Storage delete my files?
No. It keeps the full file in iCloud and removes only the copy on your Mac. Opening the file downloads it again.
Is there a way to keep all iCloud Drive files off my Mac?
Not with a setting. Optimize Mac Storage acts when space runs short, and Remove Download is something you do by hand. A cloud drive built to keep files off the disk, such as CloudRoomy (we make it), works that way by default.
Sources, checked 16 November 2026: Apple, Store files in iCloud Drive on Mac (macOS Tahoe 26); Apple, Work with folders and files in iCloud Drive; Apple, Check your iCloud Drive file and folder status on Mac; Apple, Optimize storage space on your Mac; Apple, Optimize storage in Photos on Mac; Apple, Manage your iCloud storage on your Apple device; Apple, iCloud+ plans and pricing; CloudRoomy, our own plans and prices.
Which icon did you find? Write to hello@cloudroomy.app if one of these steps has changed.