iCloud on a Mac: the status icons and what each one is telling you

A file in iCloud Drive has a small cloud next to its name, and the file next to it has nothing. A folder shows a shaded circle that fills in slowly. The sidebar itself picks up an icon that was not there yesterday. None of these are labelled, and the setting that controls them is three levels down in System Settings, under a name that does not mention the Finder at all.

There are six status icons plus a progress indicator, and each one answers a different question. Two of them are about a single file. Two are about the storage plan. One is about a choice that was made deliberately at some point, possibly by accident. Sorting out which is which takes a few minutes and removes most of the guessing about whether a document will open on a plane.

Where iCloud reports its status, and where it does not

iCloud Drive does not put an item in the menu bar. That is worth stating plainly, because most other sync services do, and people who have used one of those tend to look up at the top right of the screen first. iCloud reports itself in the Finder instead: next to individual file and folder names, and next to iCloud Drive in the Finder sidebar.

Apple's own instruction for reading the overall state is a hover, not a click on a menu bar item. The tip in the iCloud Drive documentation is to hold the pointer over iCloud Drive in the Finder sidebar, then click the status or information icon. That gives the overall picture for everything moving in either direction.

For per-file detail there is a column that is turned off by default. Open a Finder window, click iCloud Drive in the sidebar, choose View and then as List, then choose View and Show View Options and select iCloud Status. A named column appears, which is considerably easier to read than a row of small symbols.

Even with the column off, the symbols still appear next to names, with one exception that catches people out.

Tip: Even if the iCloud Status column isn't in the Finder window, the status icon for most iCloud file transfers appears next to the folder or file name. The only icon that doesn't appear is for downloaded items. Source: support.apple.com, read September 27, 2026

So a file with no icon at all is usually the healthiest case, not a broken one. It is downloaded, current, and ready to open with the network off.

The six states, in one table

Each status answers a question about one item. The table below lists Apple's names for them, which is the vocabulary to use when searching for anything further.

Status	What it is saying	What it usually means next
In iCloud	The item is only in iCloud, not on this Mac	Needs a connection, or a download, before it will open
Downloaded	The item matches between Mac and iCloud	Opens and edits offline, no action needed
Keep Downloaded	Someone chose to keep this item local	It stays even when space runs short
Waiting to Upload	The item is not yet stored in iCloud	It exists on this Mac only, so far
Ineligible	The item could not be stored in iCloud	Usually a size problem, not a network one
Out of Space	There is not enough iCloud storage left	A storage decision, not a file decision

The progress indicator sits outside that list. Apple describes it as a pie chart that changes gradually from clear to dark to indicate the progress of a file transfer, and notes that the same pie chart next to iCloud Drive in the sidebar shows the overall progress for files moving in and out. A pie chart on the sidebar with none on any visible file simply means the activity is somewhere else in the tree.

Waiting to Upload is the one worth reacting to before closing a laptop lid. It means the only copy is the local one. A Mac that goes into a bag at that moment carries the only copy with it.

In iCloud, Downloaded, and the two commands that move between them

The pair that matters for day to day work is In iCloud and Downloaded, because the difference between them is whether a file opens with no network.

To bring an item down, Control-click the items marked as In iCloud and choose Download Now. Apple's note afterwards is the point of the exercise: once the items are on the Mac, they can be worked with without an internet connection. To send one back up and reclaim the local space, Control-click the item and choose Remove Download.

The third command is the one that prevents a repeat. Control-click an item and choose Keep Downloaded, and the item stays on the Mac regardless of pressure on the disk. A checkmark appears on the menu item, and choosing it again removes the protection. This only matters when Optimize Mac Storage is on, which is covered further down, but marking the handful of files that must always be local is a two minute job with a long payoff.

Dragging is a fourth, sharper option. Dragging an item out of iCloud Drive into another folder copies it to the Mac and removes it from iCloud Drive on every device signed in to the same account. That is a genuine removal rather than a local copy, so it is the wrong gesture for tidying and the right one for taking something out of sync entirely. Apple notes that the move is reversible by dragging the items back, which is true of the file but not of any collaboration that was attached to its old location.

The practical routine before travel is short. Switch the Finder window to list view, sort by the iCloud Status column, and every item still marked In iCloud collects at one end of the list. Select the ones that matter, Download Now, and confirm the icons clear before the network goes away. Doing it in that order takes less time than opening files one by one to find out which ones stall.

When the icon is about the storage plan, not the file

Two of the six states are not really about the item they sit next to.

Out of Space means the item cannot be stored because there is no iCloud storage left. The same icon can appear next to iCloud Drive in the sidebar, where Apple's documentation says it indicates that iCloud storage is full. Nothing about the individual file is wrong. Apple's behaviour in this case is reassuring and easy to miss: the document stays on the Mac, and it is uploaded to iCloud Drive when space becomes available.

Ineligible is the odder one. It means the item could not be stored in iCloud, and Apple gives the usual reason as size, specifically that it exceeds the 50 GB limit for an individual folder or file in iCloud Drive. A disk image, a video export, or a folder that has quietly grown past that line will show this and keep showing it no matter how much storage is bought.

Storage is shared, which is why a photo library can break a document. iCloud Drive shares the same allowance as iCloud Photos, device backups, and messages and attachments in iCloud Mail. Checking which of those is consuming it is done in System Settings, under the account name at the top of the sidebar, then iCloud and Manage, where a bar at the top breaks usage down by category and clicking an entry shows the detail.

The three settings behind all of it

The icons are downstream of three switches, all in the same place: System Settings, the account name at the top of the sidebar, then iCloud, then Drive.

Sync this Mac is the master switch. With it off, this Mac simply does not participate, and Apple's own note is that devices with iCloud Drive turned off are not kept up to date with the ones that have it on.

Desktop & Documents Folders moves those two folders into iCloud Drive, after which they appear in the iCloud section of the Finder sidebar. Apple attaches a warning to this one that is easy to skip past and expensive to ignore: any other third-party app or cloud service that syncs those same folders may need to be turned off first, because two services syncing one folder can interfere with or stop the updating.

Optimize Mac Storage is what turns In iCloud icons into a normal part of the day. With it on, older documents are stored in iCloud when more space is needed. With it off, and Apple is explicit about this, the full contents of iCloud Drive remain on the Mac. A person who never wants to see a cloud icon again, and has the disk for it, turns this off rather than downloading files one at a time.

A related switch lives elsewhere, under General and then Storage, where the Store in iCloud recommendation bundles the Desktop and Documents behaviour together with photos and messages. Both routes change the same underlying settings, which is why a change made in one place shows up in the other.

What 5 GB covers, and what the next step costs

Every Apple Account starts with 5 GB of free iCloud storage, and purchases from the App Store and iTunes Store do not count against it. That allowance is spent on photos, videos, files, and device backups, which is why a single iPhone backup can fill it.

iCloud+ is the paid tier. In the United States, monthly prices run $0.99 for 50 GB, $2.99 for 200 GB, $9.99 for 2 TB, $29.99 for 6 TB, and $59.99 for 12 TB, and every tier can be shared with up to five other family members. Prices are set per country, so the figures above are the US list and not a universal one. Along with the space, iCloud+ adds iCloud Private Relay, Hide My Email, custom email domains, and HomeKit Secure Video support, with the number of supported cameras rising by tier.

For an Out of Space icon the decision is a short one. Either the 50 GB tier removes the problem for the price of a coffee, or the storage is going somewhere unexpected and the Manage screen will name it. For an Ineligible icon, no plan helps, because the 50 GB per item ceiling does not move.

What to change first

Turn on the iCloud Status column so the symbols become words, then decide once whether Optimize Mac Storage belongs on this particular Mac rather than fighting individual files. If the reason the Finder sidebar is being watched at all is that sync tools are hard to keep track of, the same question applies to the top of the screen, where every one of them wants a permanent icon, and Koffret is for deciding which of those stay visible.