How Windows 11 File Explorer Cloud Status Works

The integrated cloud status indicator in Windows 11 File Explorer provides real-time visual feedback on the synchronization state of files and folders stored in cloud services like Microsoft OneDrive. By leveraging the Windows Cloud Files API and the “Files On-Demand” architecture, File Explorer displays specific glyphs in the “Status” column and as icon overlays, allowing users to instantly see whether an item is stored locally, saved exclusively in the cloud, currently syncing, or experiencing an error.

The Underlying Technology: Files On-Demand and Cloud Filter API

Windows 11 communicates with cloud storage providers using the Cloud Filter API (cfapi). Instead of downloading an entire cloud directory to the local drive, Windows generates “sparse” or placeholder files. These files contain metadata—such as file name, size, and date modified—without consuming full local storage capacity.

When an application or user accesses a placeholder file, the operating system intercepts the request, calls the cloud provider’s sync engine, hydrates the file (downloads the actual data stream in real time), and opens it seamlessly. The status indicator reflects the exact stage of this hydration and synchronization lifecycle.

Key Cloud Status Indicators and Their Meanings

File Explorer utilizes standardized icons within the dedicated Status column to convey state:

• Blue Cloud Icon (Online-Only): The file exists exclusively on the cloud server. It occupies virtually zero disk space on the local drive. A local copy is only downloaded when the file is opened or manually set to download.
• Green Circle with a Green Checkmark (Locally Available): When an online-only file is opened, it downloads to the device and transitions to a locally available file. It can be viewed offline, but Windows Storage Sense may automatically convert it back to an online-only state if disk space runs low.
• Solid Green Circle with a White Checkmark (Always Available): Applied when a user explicitly selects “Always keep on this device.” These files are permanently downloaded, available offline, and will never be offloaded automatically by system storage optimization tasks.
• Two Blue Circular Arrows (Syncing): The file or folder is actively transmitting changes. This occurs during an upload of local modifications, a download of cloud changes, or during the initial indexing process.
• Red Circle with a White “X” (Sync Issue/Error): The sync engine encountered an error. Common causes include network interruptions, filename character restrictions, authentication issues, or reaching cloud storage limits.
• Person Icon Overlay: While not strictly a sync status, this badge indicates that the file or folder has shared access permissions configured with other users.

Controlling Cloud File States

Users can manage these states directly through the File Explorer context menu:

• Free up space: Right-clicking a local or pinned file and selecting this option purges the local data payload while retaining the metadata, instantly changing the indicator back to the Blue Cloud icon and reclaiming hard drive space.
• Always keep on this device: Right-clicking an online-only item and selecting this option forces an immediate download and locks the indicator to the Solid Green Circle, ensuring perpetual offline availability.