OneDrive File Issues

How to Fix an Incorrect OneDrive Documents Symlink on Mac

Guest WriterGuest Writer Oct 8, 2026 871 views

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.

How to Fix an Incorrect OneDrive Documents Symlink on 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.
Before you start

Ensure you have full administrator privileges on your Mac and temporarily pause OneDrive syncing before modifying system symlinks.

Solution 1Recommended

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.

1
Quit OneDrive

Click the OneDrive cloud icon in the Mac menu bar, select the gear icon (Settings & Help), and click 'Quit OneDrive'.

2
Locate and Delete the Incorrect Symlink

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'.

3
Create a New Symlink

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.

4
Restart OneDrive

Open your Applications folder and launch OneDrive again. Check if the Documents shortcut now successfully directs you to the correct folder.

Delete and Recreate the OneDrive Symlink on Mac
Contact Microsoft Support: Because modifying symlinks on macOS can be complex, contact Microsoft Support for specialized log collection if the folder mapping issue persists.
Free Microsoft Office alternative

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. 1. Download WPS Office: Visit the official WPS website and download the macOS installation package.
  2. 2. Install the Application: Open the downloaded file and drag the WPS Office icon into your Mac's Applications folder.
  3. 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.
Fully compatible with Microsoft Office formats (.docx, .xlsx, .pptx)Built-in cloud storage for easy and reliable document backupLightweight application that runs smoothly on macOSFree alternative with a familiar, easy-to-use interface
microsoft office alternative - wps office

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.