OneDrive File Issues

How to Fix OneDrive Not Syncing Files Through a Symbolic Link

Chanuka Geekiyanage Sep 29, 2026 869 views

Question details

The user wants to synchronize directories located outside the default OneDrive folder using a symbolic link, but OneDrive fails to upload the targeted files.

How to Fix OneDrive Not Syncing Files Through a Symbolic Link

Product: Microsoft OneDrive
Device & OS: not provided
Scenario: Attempting to include external local folders in OneDrive cloud backups by creating a symbolic link pointing to them from within the OneDrive directory.
Observed behavior: OneDrive displays status messages indicating it is looking for changes or is fully synchronized, but it does not actually upload the files located in the external folder targeted by the symbolic link.

Before you start

Verify the exact local path of the external files you are trying to sync and ensure they are not currently open in a development environment or another program, as active file locks can prevent successful folder relocation.

Solution 1Recommended

Move the Target Folder Directly into the OneDrive Directory

Because OneDrive is specifically designed to sync files within its designated folder structure and does not officially support symbolic links to external locations, moving the physical folder is the most reliable method.

Microsoft OneDrive processes file metadata and changes directly from its native folder path. When it encounters a symbolic link pointing elsewhere, its sync engine often fails to monitor file modifications correctly, leading to false 'synchronized' statuses.

Locate the external folder

Open File Explorer and navigate to the local directory containing the files you originally tried to link to OneDrive.

Move the folder into OneDrive

Right-click the folder and select 'Cut'. Navigate to your default OneDrive directory (typically located at C:\Users\[YourUsername]\OneDrive), right-click an empty space, and select 'Paste'.

Create a local shortcut for convenience

If you still need to access this folder from its original location on your drive, right-click the folder now residing in OneDrive, select 'Show more options' (on Windows 11) or directly choose 'Create shortcut', and move that shortcut back to your preferred local path.

Move the Target Folder Directly into the OneDrive Directory

Filename and Path Restrictions: If you are moving development folders (like Visual Studio projects), be aware that OneDrive has strict filename character restrictions and path length limits that may prevent certain temp or system files from syncing.

Free Microsoft Office alternative

Try WPS Office for Seamless Document Management and Cloud Sync

If you frequently encounter sync limitations with Microsoft OneDrive and Office setups, WPS Office offers a highly compatible, lightweight, and hassle-free alternative with its own built-in cloud storage integration.

1. Download the installer: Visit the official WPS Office website and click the Free Download button.
2. Install the software: Run the downloaded executable file and follow the quick on-screen installation prompts.
3. Sign in to activate cloud features: Launch WPS Office and sign in to enable the built-in WPS Cloud auto-sync functionality for your documents.

Fully compatible with Microsoft Office formats (.docx, .xlsx, .pptx).Built-in WPS Cloud simplifies file synchronization without complex folder configurations.Lightweight application that uses minimal system resources.Familiar user interface makes migrating from Microsoft Office effortless.

microsoft office alternative - wps office

Frequently Asked Questions

Why does OneDrive say it is synchronized when my symbolic link files are missing?

OneDrive's sync engine only monitors its own folder structure for background changes. It registers the creation of the symbolic link itself as a small file or shortcut, which it successfully syncs, but it does not index or upload the heavy files stored at the external destination.

Can I force OneDrive to exclude specific subfolders if I move my main directory into it?

Yes. Once your main folder is inside the OneDrive directory, you can right-click the OneDrive icon in your system tray, go to Settings, click on the Account tab, and select 'Choose folders'. Unchecking a subfolder will stop it from syncing, though this also removes it from your local PC.

Are there specific file types OneDrive refuses to sync?

OneDrive blocks files containing restricted characters (such as ", <, >, |, :, *, ?) and certain reserved system names. This frequently causes issues for developers trying to sync node_modules, Visual Studio caches, or temporary build files.

Document & File Issues