OneDrive Files Showing as “Online Only” but Won’t Download

When OneDrive files display a blue cloud status icon indicating they are “Online-only”, double-clicking them should prompt Windows to download the file content locally on demand. When this fails, the file hangs on “Downloading,” displays error codes like 0x8007016A or 0x8007017B, or reports that the cloud file provider is not running. This leaves local desktop applications unable to open or read the file.

Fast Fix:

Check if OneDrive is paused or signed out, then force a manual local hydration. Right-click the affected file or folder in File Explorer and select Always keep on this device. If the download stalls, restart OneDrive from the Start menu or reset its local cache via the Run dialog (Win + R) using %localappdata%\Microsoft\OneDrive\onedrive.exe /reset.

Diagnostic Snapshot

• Direct Causes: Windows Cloud Files Filter driver (cldflt.sys) communication failure, blocked background sync connections, insufficient local disk space, or corrupted placeholder metadata.
• Risk Level: Low. Your actual data remains preserved in the Microsoft 365 cloud and can be accessed immediately via OneDrive on the web.
• Scope: Local Windows file system virtualization; cloud copies remain intact.

Why Online-Only Files Fail to Download

OneDrive uses Files On-Demand to save local disk space. When a file is “Online-only,” Windows creates a placeholder file on your NTFS drive with a reparse point containing cloud metadata rather than the actual file bytes.

When you request the file, the Windows Cloud Files Filter driver (cldflt.sys) intercepts the read call and tells the OneDrive background engine to fetch the raw data stream from the cloud.

The download breaks when:

• The Cloud Filter Driver Desynchronizes: If the OneDrive background service stops responding or crashes silently, Windows cannot hand off the hydration request. This often throws How to Fix OneDrive “0x8007016A” Cloud File Provider Error.
• Local Drive Capacity is Exhausted: If your physical hard drive lacks sufficient contiguous space to write the full payload, Windows blocks the hydration request even though the cloud account has ample storage, mimicking How to Fix “OneDrive is Full” Error when You Have Space.
• Session Authentication Drops: If your Microsoft 365 token expires or gets stuck in a broken authentication state, the client displays files from cache but cannot authorize inbound data transfers, as seen in OneDrive “Grey Cloud” Icon (Not Signed In/Not Setup).

Step-by-Step Troubleshooting

Work through these steps in order to re-establish the connection between the Windows file system and the OneDrive sync engine.

1. Force Manual Hydration

Bypass the automatic on-demand trigger to see if the sync engine can establish an active download queue:

1. Open File Explorer and go to your OneDrive folder.
2. Right-click the file or folder that refuses to open.
3. Select Always keep on this device.
4. Observe the status icon:
   • A solid green circle with a white checkmark indicates successful download.
   • If the icon shifts to a red X, the sync client hit a direct download block. Proceed to Troubleshooting the “Red X” Icon on OneDrive Folders (2025 Fixes).
   • If the status remains a blue cloud with no network activity, the cloud filter driver is unresponsive.

2. Verify Physical Drive Space and Storage Sense Settings

Windows Storage Sense can automatically turn downloaded files back into online-only placeholders or block incoming writes if disk thresholds are breached.

1. Go to Windows Settings > System > Storage.
2. Confirm your local drive (typically C:) has adequate free space to receive the downloaded files.
3. Click on Storage Sense and verify whether aggressive cleanup policies are clearing local caches prematurely, which can cause conflicts detailed in OneDrive “Storage Sense” Conflict causing Data Loss.

3. Restart the Windows Cloud Files Driver

If the local file system service lost its connection to OneDrive:

1. Press Windows Key + S, type cmd, right-click Command Prompt, and select Run as administrator.
2. Run the following command to check if the driver service is running: sc query cldflt
3. If the state is not RUNNING, restart it by executing: net stop cldflt net start cldflt
4. Restart File Explorer via Task Manager or reboot the computer.

4. Reset the OneDrive Client Engine

A reset purges corrupted placeholder pointers and forces OneDrive to re-establish its link with the Windows File System without deleting your cloud files.

1. Press Windows Key + R to open the Run prompt.
2. Enter the following command and press Enter: %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
3. Wait 2 minutes for the system tray icon to clear and re-appear. If it does not restart automatically, run: %localappdata%\Microsoft\OneDrive\onedrive.exe
4. For a full breakdown of reset parameters across different install locations, reference How to Reset the OneDrive Sync Client (The Complete Command List).

Diagnostic Branching & Deeper Checks

• If downloads stall during bulk sync passes: The client may be caught in an indexing stall rather than a network error. Check if the engine is stuck in How to Fix OneDrive “Scanning Files” Infinite Loop or OneDrive Stuck on “Processing Changes” for Hours.
• If the file downloads on personal Wi-Fi but fails on corporate networks: Tenant endpoint filtering, SSL inspection, or bandwidth limits may be throttling raw file downloads. Review Resolving OneDrive “Bandwidth Limit” Sync Throttling.
• If the file path is excessively long: Deeply nested folders can cause placeholder hydration to fail silently because the local absolute path exceeds standard Windows MAX_PATH limits. Refer to Resolving “File Name is Too Long” OneDrive Sync Failures.

Escalation & Direct Workaround

If you need immediate access to the file while troubleshooting:

1. Open a web browser and navigate to OneDrive for Web or your organization’s SharePoint portal.
2. Sign in and locate the file.
3. Click Download from the top toolbar to save a direct copy to your local Downloads folder.

If multiple users on the same managed network encounter online-only hydration failures simultaneously, have an administrator verify Microsoft 365 tenant endpoint rules and Intune/Group Policy configurations under OneDrive “Settings Grayed Out” (Organization Managed).