OneDrive File Issues

How to Keep OneDrive Files Locally Available on macOS

Maira Mehtab Sep 22, 2026 869 views

Question details

The user wants to keep OneDrive files locally available in standard folder locations on macOS to enable proper Spotlight indexing and Time Machine backups.

Product: OneDrive for Mac
Device & OS: macOS
Scenario: Reinstalling OneDrive and configuring Files On-Demand to keep thousands of files stored locally for backups and fast search.
Observed behavior: Files marked as 'Always Keep on This Device' are downloaded but stored in a hidden cache folder rather than the ordinary OneDrive directory, preventing Time Machine from backing them up properly and limiting Spotlight indexing.

Before you start

Verify that your Mac is running macOS Monterey 12.1 or later, as this determines whether OneDrive uses the newer Apple File Provider integration for Files On-Demand.

Solution 1Recommended

Manage Files On-Demand via Apple File Provider API

Understand how the macOS File Provider framework handles local OneDrive files and adjust your configuration to work within its design constraints.

With recent macOS updates, OneDrive integrates with Apple's native File Provider API. When you mark files to always be kept on your device, OneDrive’s Files On-Demand system downloads them, but places the actual file data inside a hidden system cache (~/Library/CloudStorage) rather than your standard visible OneDrive folder.

This hidden cache is a strict design limitation imposed by the macOS architecture for cloud storage services. You can change where the main OneDrive folder and its cache reside during initial setup, but you cannot force the cache files to sit as raw data directly inside the visible folder.

Pin files for local availability

Open Finder, navigate to your OneDrive folder, right-click the files or folders you need, and select 'Always Keep on This Device'. A solid checkmark icon indicates the file is downloaded to the hidden cache.

Change the OneDrive sync location

If you need the hidden cache moved to an external drive (formatted as APFS), click the OneDrive cloud icon in the menu bar, select the Gear icon > Settings > Account, and click 'Unlink this Mac'. Sign back in and use the 'Change Location' button during the setup wizard to select your external drive.

Submit feedback to Microsoft

Since this cache behavior breaks traditional Time Machine backups for visible files, click the OneDrive menu bar icon, go to Settings (Gear icon), and select 'Send Feedback' to request alternative sync options.

Time Machine Limitation: Because your visible files are effectively placeholders pointing to the hidden File Provider cache, Time Machine may only back up the aliases, not the actual file data. Consider using a secondary cloud backup or duplicating critical files to a standard local folder.

Free Microsoft Office alternative

Try WPS Office for Seamless Document Management on Mac

If you are frustrated with complex OneDrive sync behaviors, hidden caches, and backup issues on macOS, WPS Office offers a powerful, lightweight, and free alternative to Microsoft Office. It includes an integrated, easy-to-understand WPS Cloud service for straightforward file storage without macOS File Provider restrictions.

1. Download and install: Download WPS Office for Mac from the official website and move it to your Applications folder.
2. Open your files directly: Launch WPS Office and open your existing Microsoft Office documents without needing conversion.
3. Save and sync securely: Save your work directly to your Mac's local drive for standard Time Machine backups, or use WPS Cloud for cross-device syncing.

Highly compatible with Microsoft Office formats like .docx, .xlsx, and .pptxBuilt-in WPS Cloud provides straightforward, transparent file syncingLightweight architecture ensures fast performance on all macOS versionsAll-in-one suite combining Word, Excel, PowerPoint, and PDF editing tools

microsoft office alternative - wps office

Frequently Asked Questions

Why are my downloaded OneDrive files missing from Time Machine backups?

On newer versions of macOS, OneDrive relies on the native File Provider framework. Locally downloaded files are kept in a hidden system cache (~/Library/CloudStorage). Time Machine often ignores this cache or fails to back up the visible placeholder files correctly.

Can I move the hidden OneDrive cache to an external hard drive?

Yes, you can move your OneDrive sync location to an external drive, provided it is formatted as APFS. When you change the location during the initial OneDrive setup, the macOS File Provider cache will also be created on that external drive.

How can I fix Spotlight indexing issues with my OneDrive files?

Because the files are managed via the File Provider cache, Spotlight can sometimes fail to index them reliably. Forcing Spotlight to rebuild its index by dragging your Mac's primary drive into Spotlight Privacy settings and removing it again can sometimes resolve search issues.

Is it possible to disable Files On-Demand and revert to the classic OneDrive sync method?

No. Microsoft has fully transitioned to the Apple File Provider API for all macOS devices running Monterey 12.1 or later. The classic sync engine is no longer supported on modern macOS systems.

Document & File Issues