iCloud storage on a Mac: why the bar fills up faster than the disk
A notification says iCloud storage is full. The Mac reports two hundred gigabytes free. Nothing about that is contradictory, and the confusion behind it is the single most common misreading of how iCloud works on a Mac: there are two meters, they measure different things, and only one setting makes them affect each other.
The disk meter counts bytes on the internal drive. The iCloud meter counts bytes held on Apple's servers under a storage plan. A file can occupy both, one, or neither. Sorting out which of the two is actually short of room is the first step, because almost every fix applies to one side and does nothing for the other.
Two meters, and where each one lives
The Mac side is at Apple menu > System Settings, General in the sidebar, then Storage. On versions before macOS Ventura 13 the same chart sits under About This Mac and then Storage. Apple describes the bar chart there as showing "used and available storage on your Mac," broken down by apps and file types.
The iCloud side is somewhere else entirely, which is a large part of why people confuse them. It is at System Settings, then your name at the top of the sidebar, then iCloud, then Manage. Apple describes what appears there plainly: "The storage bar at the top shows your total storage use, organized by categories," and clicking an app or feature in the list shows how that one is using storage.
The two screens never show the same number, and they are not supposed to. A photo library kept in iCloud Photos at full resolution counts fully against the iCloud plan while occupying very little of the disk. A virtual machine image counts fully against the disk and nothing at all against iCloud. Reading one screen and drawing a conclusion about the other is how an afternoon gets spent deleting the wrong things.
What is sharing the iCloud plan
The iCloud meter fills faster than people expect because far more feeds it than most users have in mind. Apple's own list, in the documentation for iCloud Drive, is direct.
iCloud Drive shares your iCloud storage with iCloud Photos, iPhone and iPad backups, messages and attachments in iCloud Mail, and more. Source: support.apple.com, read September 28, 2026
Two of those are usually the whole story. Device backups are the first. An iPhone with a large photo library and an iPad that was set up once and rarely used can between them hold more of the plan than every document in iCloud Drive. Because those backups happen on the phone, nothing on the Mac ever suggests they exist.
Photos is the second. iCloud Photos stores the library rather than a copy of it, which means the plan has to hold every original at full size regardless of what the Mac keeps locally.
Mail and Messages are the quiet third contributor. Mail counts only if the account is an iCloud mail address, in which case years of attachments sit in the plan rather than on any disk. Messages in iCloud does the same for conversation history, and attachments in a long group thread add up in a way that no screen on the Mac ever shows.
There is a fourth item that belongs on this list only once a specific setting is on. Turning on Desktop & Documents Folders moves those two folders into iCloud Drive, which means everything loose on the desktop starts counting against the plan. Apple attaches a warning to that switch worth reading before flipping it: when iCloud Drive is set to update the Desktop and Documents folders, any other third party app or cloud service syncing those same folders may need to be turned off, because that syncing can interfere with or stop the updating iCloud Drive performs.
The free allowance is 5 GB. Apple states it as a property of the account rather than of the device: signing in to an Apple Account and turning on iCloud gets 5 GB of free storage automatically. That figure has not moved in years, and a single iPhone backup can exceed it, which is why the first upgrade prompt usually arrives within days of setting up a new device rather than after months of use.
The one setting that couples the two numbers
Left alone, the disk and the plan are independent. One setting ties them together, and knowing exactly what it does is worth more than any amount of manual tidying.
Optimize Mac Storage lives under System Settings, your name, iCloud, then Drive. Apple's description of the behaviour is short and precise: the Mac can automatically store documents in iCloud when more space is needed, and if space is not needed, the full contents of iCloud Drive remain on the Mac.
That second clause is the part that surprises people. Turning the setting on does not immediately reclaim disk space. It grants permission to reclaim space later, under pressure. A Mac with a half empty disk and Optimize Mac Storage switched on will keep every file local, and the Storage screen will look exactly as it did before.
The wider version of the same idea appears as a recommendation on the Storage screen itself. Apple describes Store in iCloud as storing Desktop and Documents files in iCloud Drive, photos and videos in iCloud Photos, messages and attachments in iCloud, and then "optimize storage by keeping only recently opened files on your Mac when space is needed."
There is a real trade in accepting that, and it is worth stating rather than discovering. A file that has been evicted from the disk needs a network connection to open. For a desktop machine that is always online, this costs nothing. For a laptop that spends time on trains and planes, it means a document that used to open instantly now sometimes does not open at all.
The documented way to move one file either direction
macOS exposes this eviction directly, which is useful when the question is about one large folder rather than about a policy. The brctl utility is documented as the tool that manages the CloudDocs daemon, and two of its commands are the whole mechanism: download followed by a path "download a local copy of the document at this path," and evict followed by a path "evict the local copy of the document at this path."
Reading those two descriptions together settles a common worry. Eviction removes the local copy, not the file. The bytes stay in the plan, and the reverse command brings them back.
What the Storage screen counts as iCloud Drive
The Storage screen has a row labelled iCloud Drive, and it does not mean what the name suggests.
iCloud Drive: Contains all files stored in iCloud Drive. It may also contain files in your Desktop and Documents folders if you store them in iCloud Drive. Source: support.apple.com, read September 28, 2026
That row is reporting disk space, on the Mac, consumed by files that also live in iCloud Drive. It is not a reading of the plan. When Optimize Mac Storage evicts a set of documents, this row shrinks while the plan stays exactly where it was.
One footnote on the same screen catches people who are trying to reclaim space by deleting. The Trash category contains items you deleted, and items deleted from iCloud Drive are not included in that amount of storage space. Emptying the Trash on a Mac therefore does nothing for the iCloud side of the ledger, and files removed from iCloud Drive need to be dealt with through iCloud rather than through the Finder.
Which side to work on
The fix depends entirely on which meter is short, and the two lists barely overlap.
| Symptom | Which meter is full | What actually helps |
|---|---|---|
| Upgrade prompts, sync stops, photos stop uploading | The iCloud plan | Delete an old device backup, reduce iCloud Photos, or raise the plan |
| Installers fail, a macOS update says there is not enough room | The Mac disk | Empty the Trash, clear Downloads, move large libraries out |
| A document will not save to iCloud Drive | The iCloud plan | Free plan space, the file stays local until room appears |
| The disk is full and the plan has room | The Mac disk | Turn on Optimize Mac Storage, then let pressure do the work |
The third row has a detail worth knowing before panicking about it. Apple states that when a document cannot be moved or saved to iCloud Drive because the plan is full, the document stays on the Mac and is uploaded when space becomes available. Nothing is lost at that moment. What stops is the syncing, which is a different and quieter failure.
Deleting on the iCloud side is done in the same Manage screen. Backups are the highest yield target, and Apple attaches an explicit warning to them: deleting the iCloud backup for the iPhone or iPad currently in use stops iCloud from automatically backing that device up. Two categories cannot be removed that way at all. Apple notes that Delete from iCloud is not available for every app or feature, naming Messages and iCloud Drive, and that the way to handle those is to turn the feature off in iCloud settings and delete items manually.
What more room costs
When the plan is the constraint and the contents are all wanted, the honest answer is to buy space rather than keep pruning. Apple's published monthly prices in US dollars are below, and the page notes that all iCloud+ plans can be shared with up to five other family members at no extra cost.
| Plan | Monthly price in USD |
|---|---|
| iCloud, 5 GB | Free |
| iCloud+, 50 GB | $0.99 |
| iCloud+, 200 GB | $2.99 |
| iCloud+, 2 TB | $9.99 |
| iCloud+, 6 TB | $29.99 |
| iCloud+, 12 TB | $59.99 |
Prices vary by region, and Apple notes that iCloud+ may not be available in all countries or regions. The family sharing clause is the part most often left on the table: a household running four devices on four separate free accounts is paying nothing and getting 5 GB each, where one 200 GB plan covers all of them.
Where the clutter shows up on screen
Anyone running iCloud Drive alongside a second or third sync service ends up watching three separate status indicators, because each client installs its own. Add a backup indicator, a VPN state and a battery tool and the menu bar is doing real work as a dashboard.
It is also the one part of the screen with no overflow. New icons push older ones left until they slide under the notch on a laptop, and the sync indicator that was there to show whether uploads had finished becomes the one that is never visible. Quitting the clients removes the icon and the sync with it, which is not a fix.
A menu bar organizer handles the layout rather than the tool count. The indicators that matter today stay visible, the rest sit behind a divider, and a hidden icon can still be clicked with its menu opening normally. The differences between the available tools are mostly in whether a hidden group can be revealed automatically when something needs attention.
What to change first
Find out which meter is short before deleting anything: the Storage screen for the disk, and iCloud settings then Manage for the plan. If the plan is the problem, open Backups first, because an old device backup is usually the largest single item and the cheapest to give up. And if the investigation ends with three sync clients competing for space at the top of the screen, Koffret is for deciding which of them earns a permanent slot.
Frequently asked questions
Why does iCloud say my storage is full when my Mac has plenty of free space?
Because they are two different meters. The Mac figure counts bytes on the internal disk, and the iCloud figure counts bytes held under the storage plan on Apple's servers. iCloud Drive shares that plan with iCloud Photos, iPhone and iPad backups, and Mail attachments, so the plan can be full while the disk is nearly empty.
Does turning on Optimize Mac Storage free up disk space right away?
Usually not. Apple describes the setting as letting the Mac store documents in iCloud when more space is needed, and states that if space is not needed, the full contents of iCloud Drive remain on the Mac. It is permission granted in advance rather than an immediate cleanup, so the Storage screen often looks unchanged for days.
If I delete a file from iCloud Drive, does it free up space on my Mac?
It frees space on both sides once the deletion is processed, but not through the Trash. The Storage screen notes that items deleted from iCloud Drive are not counted in the Trash category, so emptying the Trash on the Mac does nothing for the iCloud plan. Removals from iCloud Drive have to be handled through iCloud itself.
What is actually using up my iCloud storage?
Open System Settings, click your name, then iCloud, then Manage. The bar at the top breaks the plan down by category, and clicking any app or feature in the list shows how much that one is holding. On most accounts the largest entries are device backups and iCloud Photos rather than documents.
How much does more iCloud storage cost?
Apple's published US prices are $0.99 a month for 50 GB, $2.99 for 200 GB, $9.99 for 2 TB, $29.99 for 6 TB and $59.99 for 12 TB, on top of the 5 GB that comes free with an Apple Account. Prices vary by region. Any iCloud+ plan can be shared with up to five other family members at no extra cost, which is often cheaper than several separate accounts.