onedrive

OneDrive Files On-Demand Not Working

Resolution Checklist

  • 1 Understand the mechanics of Files On-Demand on Windows vs macOS
  • 2 Fix Windows Files On-Demand errors and force local folder downloads
  • 3 Troubleshoot macOS Apple FileProvider sync and download faults
  • 4 Resolve error 0x8007016A (Cloud Provider Not Running)

OneDrive Files On-Demand Not Working

Files On-Demand allows you to see all your files in OneDrive without having to download them to your local device. However, this feature can fail, resulting in files stuck as “online-only” icons, download errors, or Explorer/Finder freezing when attempting to open a file.

This diagnostic manual covers how to repair Files On-Demand issues on both Windows and macOS.

1. How Files On-Demand Works (Windows vs. macOS)

Understanding the technology layer helps target the fix:

  • Windows: Uses NTFS sparse files and reparse points. The operating system handles placeholders directly via filter drivers.
  • macOS: Uses Apple’s native FileProvider API (macOS 12.1+). OneDrive mounts as a virtual network drive in the Finder sidebar under /Locations or /Library/CloudStorage/.

2. Troubleshooting Files On-Demand on Windows

A. Force Disable/Re-enable in Settings

Toggle the feature to force Windows to reload the NTFS filter driver:

  1. Click the OneDrive cloud icon in your taskbar.
  2. Click Settings (Gear Icon) → Settings.
  3. Under the Sync and backup tab, expand Advanced settings.
  4. Scroll down to Files On-Demand.
  5. Click Download all files now (to disable placeholders) or check the toggle to free up space.

B. Force Download a Folder and Subfolders via Command Prompt

If a folder fails to download via the GUI, use the NTFS attributes command:

  1. Open Command Prompt (search cmd in Start).
  2. Use the attrib command to recursively change online placeholders into offline pinned files: 
    attrib -u +p /s /d "%USERPROFILE%\OneDrive - Personal\*"
    (Adjust the path if you are using OneDrive for Business, e.g., %USERPROFILE%\OneDrive - CompanyName\)
  • -u: Removes the “online-only” attribute.
  • +p: Applies the “always keep on this device” attribute.
  • /s and /d: Tells it to apply to all subfolders and files.

3. Troubleshooting Files On-Demand on macOS

Since macOS Monterey, Apple forces all cloud apps to use the FileProvider framework, which means local folders are moved to ~/Library/CloudStorage/OneDrive.

A. Check the Apple FileProvider Cache Directory

If files refuse to download:

  1. Open Terminal (Finder → Applications → Utilities).
  2. Look for the FileProvider storage manager state list using: 
    pluginkit -m -v -a | grep -i onedrive
  3. If the extension is not showing + (active), restart the system daemon: 
    killall -9 fileproviderd

B. Clear iCloud/Local Mount Database

If files are displaying “cloud-with-arrow” download icons but clicking them fails:

  1. Disable OneDrive from startup in System Settings → General → Login Items.
  2. Open Terminal and delete the cached cloud metadata database (this does not delete your actual files, only the mounting pointers): 
    rm -rf ~/Library/Application\ Support/FileProvider/OneDrive*
  3. Restart your Mac, open OneDrive, and let it rebuild the Finder mount directory.

4. Resolve Error 0x8007016A (Cloud File Provider is Not Running)

This is the most common error associated with Files On-Demand on Windows, usually triggered when trying to copy or delete a stub file while the OneDrive sync engine is inactive.

The Immediate Fix:

  1. Open the Run prompt (Win + R), type cmd and press Enter.
  2. Run this command to check if OneDrive is running. If not, start it: 
    start %localappdata%\Microsoft\OneDrive\onedrive.exe
  3. Once the cloud icon appears in the tray, try the file operation again.
  4. If it still fails, reset the app via: 
    %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  5. Refer to the dedicated OneDrive Error Code 0x8007016A Guide for advanced Registry and PowerShell remedies.