When setting up OneDrive for Business in a small office environment, the Known Folder Move feature may fail before the setup process finishes. This typically occurs because the user’s Desktop, Documents, or Pictures folders are stored on a network drive or are redirected through Group Policy. The failure often appears as an error message stating that OneDrive cannot move the folder, and the setup wizard stops. This guide explains why Known Folder Move fails during initial configuration and provides the specific steps to resolve the problem in small office scenarios.
Key Takeaways: Fix Known Folder Move Failure on First Setup
- OneDrive Settings > Sync and backup > Manage backup: Use this path to retry Known Folder Move after fixing the folder location conflict.
- Group Policy Management Console > Folder Redirection: Check if Desktop, Documents, or Pictures are redirected to a network path; revert to local folders before enabling Known Folder Move.
- Command: %localappdata%\Microsoft\OneDrive\OneDrive.exe /reset: Reset OneDrive sync after folder changes to clear cached errors and restart the setup wizard cleanly.
Why Known Folder Move Fails Before Setup Completes
Known Folder Move is a OneDrive feature that redirects the Desktop, Documents, and Pictures folders to OneDrive for backup and sync. For the feature to succeed, these folders must reside on the local system drive, typically C:\Users\[username]. If the folders are located on a network drive, a redirected server path, or a mapped drive, OneDrive cannot move them because it requires direct file system access. The setup wizard checks the folder location immediately after the user signs in. When the location is not local, the wizard displays an error and stops the configuration.
In small offices, administrators often redirect folders to a network share for centralized backup or data management. This practice conflicts with OneDrive’s requirement for local folders. The failure is not a bug; it is a deliberate protection to prevent data loss or corruption during the move operation. The fix requires either moving the folders back to the local drive before enabling Known Folder Move or configuring OneDrive to skip the affected folders during setup.
Steps to Resolve Known Folder Move Failure During Setup
- Identify the current folder location
Open File Explorer and navigate to the user’s profile folder, typically C:\Users\[username]. Right-click the Desktop, Documents, or Pictures folder and select Properties. Go to the Location tab. If the path shows a network drive letter or a UNC path such as \\server\share\folder, the folder is not local. - Revert folder location to the default local path
In the Location tab of the folder Properties, click the Restore Default button. Windows moves the folder contents back to the default C:\Users\[username]\[FolderName] location. Click Apply and confirm any prompts. Repeat this step for each folder that shows a non-local path. - Restart OneDrive setup
Press Ctrl+Shift+Escape to open Task Manager. Find Microsoft OneDrive in the list, select it, and click End task. Then open OneDrive from the Start menu or by searching for OneDrive. Sign in with the user’s Microsoft 365 work or school account. - Manually trigger Known Folder Move again
After signing in, click the OneDrive cloud icon in the system tray. Select Help & Settings > Settings. Go to the Sync and backup tab and click Manage backup. The wizard shows the Desktop, Documents, and Pictures folders. Click the toggle switch for each folder to enable backup. OneDrive now moves the folders to the cloud without the location conflict. - Verify the move completed
Open File Explorer and check the Quick Access section. The Desktop, Documents, and Pictures folders should show a blue cloud icon or a green check mark, indicating they are synced with OneDrive. Open the OneDrive folder in File Explorer and confirm the folders appear under the user’s OneDrive directory.
If Known Folder Move Still Fails After Reverting Folder Location
Group Policy still enforces folder redirection
In small offices with Active Directory, Group Policy may reapply folder redirection on the next logon. To prevent this, the administrator must modify the policy. Open Group Policy Management Console on the domain controller. Navigate to User Configuration > Policies > Windows Settings > Folder Redirection. For each folder set to Basic or Advanced, change the setting to Not configured or select Follow the documents folder. Apply the change and run gpupdate /force on the affected workstation. Reboot the computer, then repeat the Known Folder Move steps.
OneDrive cached a stale error state
If the folder location was fixed but OneDrive still shows the error, reset the sync client. Open a Command Prompt or PowerShell window as an administrator. Type the following command and press Enter:
%localappdata%\Microsoft\OneDrive\OneDrive.exe /reset
Wait for OneDrive to restart automatically. If it does not restart, launch OneDrive from the Start menu. Sign in again and go to Settings > Sync and backup > Manage backup to retry Known Folder Move.
The folder contains files with unsupported characters or paths longer than 400 characters
OneDrive cannot move folders that contain files with names exceeding the character limit or with invalid characters such as a colon or asterisk. Use the OneDrive sync health report in the Microsoft 365 admin center to identify problem files. Move those files out of the folder manually to a temporary location, retry Known Folder Move, then move the files back into the OneDrive folder after the move completes.
Known Folder Move Local vs Redirected: Key Differences for Small Offices
| Item | Local Folder (Default) | Redirected Folder (Network) |
|---|---|---|
| Folder location | C:\Users\[username]\Desktop (or Documents or Pictures) | \\server\share\[username]\Desktop or a mapped drive letter |
| OneDrive Known Folder Move support | Supported, moves folder to cloud automatically | Not supported, setup fails with error |
| Data backup method | OneDrive cloud backup plus local copy | Server-side backup only, no cloud sync |
| Access when offline | Files available offline via OneDrive Files On-Demand | No offline access unless files are copied locally |
| Management overhead | Low, automatic sync after initial setup | High, requires server maintenance and folder redirection policies |
For small offices without a dedicated IT staff, using local folders with OneDrive Known Folder Move reduces complexity. The cloud backup eliminates the need for a local file server while still providing data protection and remote access.
You can now configure Known Folder Move successfully even if the initial setup failed due to folder redirection. After the move completes, verify that the Desktop, Documents, and Pictures folders appear in the OneDrive web portal. As an advanced tip, enable the OneDrive sync admin reports in the Microsoft 365 admin center to monitor folder move status across all users in the office without logging into each machine.