How to Fix an Incorrect OneDrive Documents Symlink on Mac
Question details
The user needs to fix a OneDrive Documents shortcut that points to the wrong folder due to a legacy symlink on a Mac.

- Product
- OneDrive
- Device & OS
- Mac
- Scenario
- After installing or setting up OneDrive on macOS, the Documents folder is pointing to an incorrect directory.
- Observed behavior
- The Documents shortcut acts as an incorrect legacy symlink, preventing proper access to the expected OneDrive Documents folder.
Ensure you have full administrator privileges on your Mac and temporarily pause OneDrive syncing before modifying system symlinks.
Delete and Recreate the OneDrive Symlink on Mac
Manually remove the incorrect legacy symlink and create a new one pointing to the correct OneDrive Documents location.
A symbolic link (symlink) acts as an advanced shortcut in macOS. If OneDrive references an outdated symlink, you must recreate it via the terminal or Finder to restore normal folder operations.
Click the OneDrive cloud icon in the Mac menu bar, select the gear icon (Settings & Help), and click 'Quit OneDrive'.
Open Finder, navigate to your user directory or the location of the incorrect Documents folder shortcut, right-click the legacy symlink, and select 'Move to Trash'.
Open the Terminal app on your Mac. Type 'ln -s' followed by a space, drag the correct OneDrive Documents folder into the Terminal window to paste its path, then type the path where you want the new shortcut to reside, and press Enter.
Open your Applications folder and launch OneDrive again. Check if the Documents shortcut now successfully directs you to the correct folder.

Manage Your Documents Seamlessly with WPS Office
While dealing with complex OneDrive folder syncing issues on your Mac, consider switching to WPS Office. It is a free, lightweight, and highly compatible alternative to Microsoft Office that offers seamless document management without complicated symlink configurations.
- 1. Download WPS Office: Visit the official WPS website and download the macOS installation package.
- 2. Install the Application: Open the downloaded file and drag the WPS Office icon into your Mac's Applications folder.
- 3. Save and Sync Documents: Launch WPS Office, sign in, and easily save your files to WPS Cloud or your local Mac directories without worrying about symlink errors.

Frequently Asked Questions
What is a symlink on a Mac?
A symlink, or symbolic link, is a special type of file in macOS that serves as a system-level reference to another file or directory. Unlike a standard Finder alias, symlinks are readable by terminal commands and cloud applications like OneDrive.
Why does OneDrive create a Documents symlink?
OneDrive uses symlinks to redirect your Mac's local folders (like Documents or Desktop) to the OneDrive cloud directory, ensuring that your files are automatically backed up and synced without duplicating storage space.
Will deleting the symlink delete my original OneDrive files?
No, deleting a symlink only removes the shortcut pointing to the folder. Your actual documents remain safe in their original location within the main OneDrive directory or on the cloud server.
How do I contact Microsoft Support for OneDrive Mac issues?
You can contact Microsoft Support directly from the app by clicking the OneDrive icon in your Mac menu bar, selecting the gear icon, and choosing 'Get Help' or 'Send Feedback' to report the problem and submit diagnostic logs.




