OneDrive File Issues

How to Change OneDrive File Location on Mac

Maira Mehtab Sep 21, 2026 868 views

Question details

The user wants to set or change the actual local cache location of OneDrive files to a custom directory, rather than using the system default.

Product: OneDrive for Mac
Device & OS: macOS
Scenario: Configuring the local synchronization folder path during or after OneDrive setup.
Observed behavior: On modern macOS versions, OneDrive forces local files into /Users/username/Library/CloudStorage/OneDrive and only creates a folder alias (shortcut) in the user-selected setup location.

Before you start

Before modifying any OneDrive synchronization settings or unlinking your account, ensure all your local files have a "green check" indicating they are fully synced to the cloud to prevent data loss.

Solution 1Recommended

Understand macOS CloudStorage Restrictions

On modern macOS versions, changing the actual local cache location is no longer supported due to Apple's system architecture, meaning custom locations will always act as aliases.

Starting with newer macOS versions (macOS 12.1 Monterey and later), Apple introduced the File Provider framework. This system mandates that all cloud storage services, including OneDrive, must store their actual synchronized local files in a designated, system-managed folder: /Users/username/Library/CloudStorage/OneDrive.

When you select a custom location during the OneDrive setup (such as /Users/username/OneDrive), macOS automatically creates an alias (shortcut) at that destination instead of storing the actual files there. The files remain safe in the cloud and are cached locally by macOS as needed.

Access Files via the Alias

Simply double-click the OneDrive alias in your chosen folder to browse and open your synced files seamlessly.

Access via Compatible Applications

Open compatible software like WPS Office or Excel. Use the "Recent files" list or the native file browser to directly open documents stored in your OneDrive.

Do Not Move the Folder Manually: Avoid attempting to manually drag, drop, or move the CloudStorage folder to a new location. Doing so can break synchronization and potentially lead to file corruption.

Solution 2

Change the Alias Location by Unlinking Your Mac

If you simply want to move where the OneDrive alias (shortcut) is located on your Mac, you can do so by unlinking and relinking your account.

Free Microsoft Office alternative

Seamlessly Edit Your OneDrive Files with WPS Office

While macOS strictly manages where OneDrive stores its local cache, opening and editing those cloud documents remains effortless. WPS Office is a free, lightweight alternative to Microsoft Office that perfectly integrates with your Mac's cloud storage directories, ensuring smooth document management without heavy system overhead.

1. Install WPS Office for Mac: Download and install the free WPS Office application tailored for macOS.
2. Open Your OneDrive Files: Launch WPS Office, click 'Open', and navigate to your OneDrive alias folder to access your synced documents.
3. Edit and Sync Automatically: Edit your documents normally. When you click save, macOS File Provider will automatically sync the changes back to your OneDrive cloud.

Fully compatible with Microsoft Office formats (Word, Excel, PowerPoint)Lightweight architecture runs incredibly fast on macOSSeamlessly opens and saves files directly from your OneDrive alias or CloudStorage directoryClean, tabbed interface to manage multiple documents in one window

Frequently Asked Questions

Why does my Mac OneDrive folder show an alias arrow on the icon?

On newer versions of macOS, Apple's File Provider framework requires cloud storage applications to keep their physical data in a hidden Library/CloudStorage folder. The folder you see in Finder is just an alias (shortcut) pointing to that system-managed location.

Can I force OneDrive to store actual files in my custom folder?

No, this is no longer supported on modern macOS versions. Moving the actual cache folder away from the system-managed path is prevented by the operating system to ensure reliable background synchronization.

How do I make sure my OneDrive files are available offline on Mac?

Right-click the specific file or folder within your OneDrive alias directory in Finder and select 'Always keep on this device'. macOS will download the file to the CloudStorage cache, allowing you to access it even without an internet connection.

Document & File Issues