OneDrive for Business Known Folder Move troubleshooting for small offices: fails before setup completes

When you try to move your Desktop, Documents, or Pictures folders to OneDrive for Business using Known Folder Move, the setup may fail before it finishes. The error often appears as a message that Known Folder Move cannot redirect these folders, or the OneDrive setup window closes unexpectedly. This issue typically occurs because of permission conflicts, folder redirection policies from a previous setup, or files that are too long or have unsupported characters. This article explains the root causes of this failure and provides step-by-step fixes for small office environments where IT support may be limited.

Why Known Folder Move Fails Before Setup Completes

Known Folder Move (KFM) fails before setup completes when OneDrive cannot redirect the local folder to the cloud location. The root cause is almost always a conflict with existing folder redirection settings or a file path that exceeds the 260-character limit. In small offices, a common scenario is that a previous IT setup or a migration from another cloud service left behind a Group Policy or registry key that locks the folder location. Another frequent cause is that the user’s Desktop or Documents folder contains a file with a name longer than 255 characters or a character that Windows does not allow in OneDrive paths, such as a colon or asterisk. OneDrive checks these conditions before starting the move and will abort if any are present.

Folder Redirection Conflicts

When a Windows domain or workgroup has previously set folder redirection through Group Policy or a third-party tool, the registry keys under HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders still point to a network path. OneDrive sees this as an unsupported target and refuses to start the KFM wizard. Even if the policy is no longer active, the registry values may remain and cause the failure.

File Name and Path Length Issues

OneDrive for Business enforces a 260-character maximum path length. If any file inside Desktop, Documents, or Pictures has a full path longer than 260 characters, the move fails. Similarly, files with names containing ", , :, <, >, ?, \, /, or | will block the move. Small office users often accumulate such files over years of local storage.

Steps to Fix Known Folder Move Before Setup Completes

Follow these steps in order. After each step, try opening OneDrive and clicking Backup > Manage backup again.

1. Check and clear folder redirection registry keys
   Press Windows + R, type regedit, and press Enter. Navigate to HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders. Look for entries named Desktop, Personal (Documents), and My Pictures. If the value data starts with \\ (a network path) or points to a drive other than C:\Users\[username], right-click the entry and select Modify. Change the value to the default local path, for example C:\Users\[username]\Desktop. Close Registry Editor and restart File Explorer from Task Manager.
2. Restore default folder locations
   Open File Explorer. Right-click the Desktop folder in the navigation pane and select Properties. Go to the Location tab and click Restore Default. Click Apply and confirm the move if prompted. Repeat for Documents and Pictures. If the Restore Default button is grayed out, the folder is already at the default location — proceed to the next step.
3. Remove Group Policy that blocks Known Folder Move
   Press Windows + R, type gpedit.msc, and press Enter. Navigate to Computer Configuration > Administrative Templates > Windows Components > OneDrive. Double-click Prevent Known Folder Move. Select Not Configured or Disabled, then click OK. If you are not on a domain, this policy may not exist — skip this step.
4. Find and fix long file paths
   Open a Command Prompt as administrator. Run the following command to scan for files with a path longer than 260 characters in your user profile: dir /s /a C:\Users\%username% > C:\filelist.txt. Open the file C:\filelist.txt in Notepad. Look for lines that end with an ellipsis or show a truncated path. For each problematic file, rename the file to a shorter name or move it to a folder with a shorter path. After fixing all files, delete the list file.
5. Remove invalid characters from file names
   In File Explorer, navigate to Desktop, Documents, and Pictures. Sort by name and look for files containing ", , :, <, >, ?, \, /, or |. Right-click each file, select Rename, and remove or replace the invalid character with a hyphen or space. Press Enter to save the new name.
6. Reset OneDrive if the wizard still fails
   Press Windows + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. Wait 30 seconds. Open OneDrive again from the Start menu. Sign in with your Microsoft 365 work or school account. Click the OneDrive icon in the notification area, select Settings, go to the Backup tab, and click Manage backup. Select the folders you want to move and click Start backup.

If OneDrive Still Has Issues After the Main Fix

OneDrive Shows a Red X on Desktop or Documents

After a successful Known Folder Move, a red X may appear on the folder icons. This usually means the folder was moved but the sync is paused or the folder is not fully uploaded. Open OneDrive, click the Pause sync icon in the notification area, and select Resume sync. If the red X persists, go to OneDrive settings > Sync and backup > Manage backup and verify the folder is listed as Backed up.

OneDrive Cannot Access the Folder After Move

If you get an access denied error when opening Desktop or Documents after the move, the folder permissions may have changed. Right-click the folder in File Explorer, select Properties, go to the Security tab, and ensure your user account has Full control. If not, click Edit, select your account, check Full control, and click Apply.

The Wizard Opens but Closes Immediately

If the Known Folder Move wizard opens and then closes without any error, OneDrive may be blocked by a firewall or proxy. Temporarily disable the firewall or add onedrive.live.com and all subdomains to the allowlist. After testing, re-enable the firewall. If the issue is in a corporate network, contact the network administrator.

Known Folder Move vs Manual Folder Backup: Key Differences

Item	Known Folder Move	Manual Folder Backup
Setup method	OneDrive Backup wizard	Drag and drop or copy-paste files into OneDrive folder
Folder redirection	Automatically redirects Desktop, Documents, and Pictures to OneDrive	No redirection; files remain in original locations unless moved manually
File path change	Original local path changes to C:\Users\[username]\OneDrive - [tenant]\Desktop	Original local path stays the same
Sync behavior	All files in the redirected folders sync automatically	Only files placed inside the OneDrive folder sync
Best for	Users who want automatic backup of all desktop and document files	Users who want selective sync and keep original folder structure

You can now run Known Folder Move without the setup failing. After a successful move, check OneDrive sync status to confirm all files are uploaded. Next, enable Files On-Demand to save local disk space by going to OneDrive settings > Sync and backup > Advanced settings and turning on Files On-Demand. As an advanced tip, use the OneDrive admin center in Microsoft 365 to enforce Known Folder Move via Group Policy for all users in your small office, which prevents future setup failures caused by manual misconfiguration.