How to Troubleshoot a Single Folder That Will Not Sync in OneDrive for Business

You have a folder in your OneDrive that refuses to sync. All other files and folders update normally, but this one folder stays stuck, shows a red X, or never appears online. The root cause is almost always a file-name conflict, a character or path-length violation, a permission mismatch, or a corrupted sync cache entry for that specific folder. This article explains why a single folder fails and provides step-by-step fixes to resolve the problem without resetting your entire OneDrive sync.

Why a Single OneDrive Folder Stops Syncing

OneDrive syncs files and folders by comparing local metadata with the server. When a single folder fails, the problem is isolated to that folder’s data or its relationship with the sync engine. The most common technical causes are:

Invalid file or folder names. OneDrive does not sync names containing the characters " : < > ? / \ |. A single file inside the folder with an illegal character blocks the entire folder. Similarly, the full path from the OneDrive root to the deepest file must be under 400 characters. Exceeding this limit stops sync for that branch.

Selective sync exclusion. You may have accidentally deselected the folder in OneDrive’s sync settings. When a folder is excluded, OneDrive does not download new changes from the cloud, and local changes stay local. The folder appears in File Explorer but never syncs.

Permission conflicts. If the folder was shared with you and the owner changed permissions, OneDrive may fail to sync until the permission refresh completes. This is rare but happens with shared folders that have complex inheritance rules.

Corrupted sync cache entry. OneDrive maintains a local database of sync states. A single folder entry can become corrupted after a network interruption or a forced OneDrive restart. The corrupted entry prevents the folder from syncing even though other folders work fine.

File lock or open handle. An application may hold a lock on a file inside the folder. OneDrive cannot sync a locked file. The folder appears stuck until the lock is released.

Steps to Fix a Single Non-Syncing Folder

Follow these steps in order. Test sync after each step to see if the folder resolves.

1. Check file names and path length
   Open the problem folder in File Explorer. Look for any file or subfolder with invalid characters: " : < > ? / \ |. Rename those items to remove the characters. Next, right-click the folder and select Properties. Count the total characters of the full path from your OneDrive root folder to the deepest file. If it exceeds 400 characters, shorten folder or file names.
2. Verify selective sync settings
   Right-click the OneDrive cloud icon in the system tray. Select Settings. Go to the Account tab. Click Choose folders. Ensure the problem folder has a check mark next to it. If it is unchecked, check it and click OK. OneDrive will download the folder contents again.
3. Rename the folder locally
   In File Explorer, rename the non-syncing folder to something temporary, for example add “-old” at the end. Wait 30 seconds. Rename it back to the original name. This forces OneDrive to re-evaluate the folder metadata and triggers a new sync attempt.
4. Run the SyncHealth command
   Press Windows key + R, type cmd, and press Enter. In the Command Prompt, type onedrive.exe /synchealth and press Enter. Review the output for folder-specific error codes. Common errors include 0x8007016A (cloud file provider error) and 0x80004005 (unspecified failure). Note the error code and search Microsoft’s support site for the exact fix.
5. Clear the sync cache for the single folder
   Close OneDrive by right-clicking the cloud icon and selecting Exit. Open File Explorer and navigate to %LocalAppData%\Microsoft\OneDrive\settings\Business1. Look for a file named ClientPolicy.db. Rename it to ClientPolicy.db.old. Restart OneDrive from the Start menu. This clears the cached policy for that folder without affecting other sync data.
6. Move the folder out of OneDrive and back in
   Cut the entire problem folder and paste it to your Desktop. Wait 10 seconds. Cut it from the Desktop and paste it back into the OneDrive folder. This removes the folder from the sync database and re-adds it as a new item.
7. Check for file locks
   Open the problem folder and look for files that are currently open in any application. Close all Office documents, PDFs, or media files inside the folder. Use Task Manager to end any process that might hold a handle on the folder. Right-click the Start button, select Task Manager, look for processes like Excel, Word, or Notepad, and end them.

If the Folder Still Has Issues After the Main Fix

OneDrive shows a red X on the folder but not on files inside

A red X on the folder itself indicates a sync error at the folder level. This often happens when the folder name contains a trailing space or a period at the end. Rename the folder to remove trailing spaces or periods. OneDrive does not sync folder names ending with a space or a period.

The folder syncs but files inside are missing

If the folder appears synced but some files are missing, the selective sync setting may have excluded specific file types. Go to OneDrive Settings > Sync and backup > Advanced settings > Files On-Demand. Ensure Files On-Demand is enabled. Then right-click the folder in File Explorer and select Always keep on this device. This forces all files inside to download.

Shared folder from another organization fails to sync

Folders shared from a different Microsoft 365 tenant may not sync due to external sharing restrictions. Ask the folder owner to reshare the folder with you. Ensure the sharing link is set to allow edit permissions. In OneDrive Settings > Account, click Add a shortcut to My Files and add the shared folder again.

Selective Sync vs Files On-Demand: Key Differences for Stuck Folders

Item	Selective Sync	Files On-Demand
Description	Choose which folders download to your PC	Decide whether files are always local or online-only
Effect on single folder	Excluded folders do not sync at all	Affects file availability but not folder sync status
Configuration location	OneDrive Settings > Account > Choose folders	File Explorer > right-click file > Always keep on this device or Free up space
Common cause of stuck folder	Folder accidentally deselected	Folder shows online-only but never downloads
Fix for stuck folder	Re-check the folder in Choose folders	Right-click folder > Always keep on this device

Selective sync controls which folders OneDrive monitors. Files On-Demand controls how files appear locally. For a single stuck folder, first verify selective sync includes the folder. If it does, use Files On-Demand to force full download.

You can now identify and fix a single folder that refuses to sync in OneDrive for Business. Start by checking file names and path length, then verify selective sync settings. If the folder still fails, rename it locally or move it out and back in. As an advanced tip, use the onedrive.exe /synchealth command to capture the exact error code for Microsoft support tickets.