Known Folder Move Fails for the Documents Folder: OneDrive for Business Fix

When you enable Known Folder Move to back up the Documents folder to OneDrive for Business, the process may fail with an error message such as “Sorry, OneDrive can’t move this folder right now” or “We can’t move your Documents folder.” This failure typically occurs because Windows still holds file locks on the folder, because the folder contains files with unsupported characters, or because Group Policy blocks the move. This article explains the root causes of the failure and provides step-by-step fixes to successfully move your Documents folder to OneDrive.

Why Known Folder Move Fails for the Documents Folder

Known Folder Move relocates the Documents, Desktop, and Pictures folders from their default local location to OneDrive. The move fails for the Documents folder when any of the following conditions are true.

The Documents folder is currently in use by another application, such as antivirus software, a backup tool, or a running program that holds file handles inside the folder. Windows cannot move a folder that is locked.

The folder contains files with names that exceed 400 characters or include unsupported characters such as asterisks, question marks, or colons. OneDrive cannot sync these files, so the move stops.

The folder path has been redirected by Group Policy to a network location or to a non-default drive. OneDrive can only move folders that reside on the local system drive, typically C:\Users\[username]\Documents.

OneDrive sync is paused, or the account license has expired. The move requires an active sync connection and a valid Microsoft 365 subscription.

Steps to Fix Known Folder Move for the Documents Folder

1. Close all open files and applications
   Save and close all documents, spreadsheets, and other files in the Documents folder. Close File Explorer windows. Quit any programs that might hold file locks, including antivirus scanners, backup software, and PDF readers.
2. Check the Documents folder location
   Right-click the Documents folder in File Explorer and select Properties. Go to the Location tab. The path must be C:\Users\[your username]\Documents. If it shows a different drive letter or a network path, click Restore Default to move the folder back to its default location. Apply the change and restart Windows.
3. Scan for unsupported file names
   Open Command Prompt as administrator. Run the following command to list files with long paths or unsupported characters: dir /s /a C:\Users\[username]\Documents | findstr /i "^[^a-z0-9._-]". Rename or delete any files that contain characters like , ?, :, <, >, or |. Also rename files whose full path exceeds 400 characters.
4. Verify OneDrive sync status
   Click the OneDrive cloud icon in the notification area. Ensure the sync status shows a solid blue or white cloud. If the cloud is gray or shows an error, click the icon and select Resume syncing. Wait until all pending changes finish syncing.
5. Check Group Policy settings
   Press Win + R, type gpedit.msc, and press Enter. Navigate to User Configuration > Administrative Templates > Windows Components > OneDrive. Double-click “Prevent users from moving Windows known folders to OneDrive.” Set it to Disabled or Not Configured. Click OK and close the editor. Run gpupdate /force in Command Prompt.
6. Restart the OneDrive process
   Right-click the OneDrive icon in the notification area and select Settings. Go to the Account tab and click Unlink this PC. Restart Windows. After restart, sign in to OneDrive again and go to Settings > Sync and backup > Manage backup. Click the Backup button next to Documents.
7. Perform a manual folder move if the automatic move still fails
   Open File Explorer. Right-click the Documents folder and select Properties > Location. Click Move. Navigate to the OneDrive folder, typically C:\Users\[username]\OneDrive – [your company name]. Create a new folder named Documents inside that OneDrive folder. Select it and click Select Folder. Click Apply and confirm the move. OneDrive will then sync the folder.

If OneDrive Still Cannot Move the Documents Folder

OneDrive shows a red circle with a white X on the Documents folder

This icon means OneDrive could not sync one or more files inside the folder. Open the OneDrive activity center by clicking the cloud icon and selecting View sync issues. Resolve each listed conflict or error. Common fixes include renaming files with forbidden characters and moving files that exceed the 250 GB per-folder limit.

The Move button is grayed out in Manage backup

This occurs when your organization uses Group Policy to block Known Folder Move. Contact your Microsoft 365 administrator and ask them to set the policy “Prevent users from moving Windows known folders to OneDrive” to Disabled. Alternatively, the admin can use the OneDrive Group Policy Objects to enable Silent Account Configuration and automatically redirect folders.

Known Folder Move was working but stopped mid-process

The move may have been interrupted by a network outage or a system restart. Open OneDrive settings and go to Sync and backup > Manage backup. If the Documents folder shows “Backup pending,” click the Stop backup button next to it. Wait 30 seconds, then click Start backup again. This forces OneDrive to restart the move from the beginning.

Known Folder Move vs Manual Folder Redirection: Key Differences

Item	Known Folder Move	Manual Folder Redirection
Method	Automatic, initiated from OneDrive Settings	User manually changes folder location via Properties > Location
Sync behavior	OneDrive automatically syncs the folder and maintains redirect	OneDrive syncs the folder only if it is inside the OneDrive folder
Group Policy support	Controlled by OneDrive-specific Group Policy settings	Controlled by Folder Redirection Group Policy in User Configuration
Error handling	OneDrive reports sync issues and conflicts	No automatic error reporting; user must verify sync manually
File restrictions	Blocks files with unsupported characters or long paths	No automatic block; files with issues cause sync errors

After completing the steps above, you should be able to move the Documents folder to OneDrive without errors. The Known Folder Move feature will keep your files backed up and accessible across all your devices. For ongoing management, check the OneDrive activity center weekly for any sync warnings. If you frequently work with files that have special characters, consider renaming them before enabling Known Folder Move to avoid future failures.