OneDrive KFM Policy Applies but Documents Stay Local

You have configured a Known Folder Move policy in Microsoft 365, but your users report that their Desktop, Documents, and Pictures folders remain on the local device instead of being redirected to OneDrive. This usually happens because the policy is not fully applied, a prerequisite is missing, or the client has not processed the latest group policy update. This article explains the root causes behind this behavior and provides step-by-step instructions to force the policy to take effect. You will also learn how to verify the policy application and resolve common failures that prevent folder redirection.

Why the KFM Policy Does Not Redirect Folders

Known Folder Move is a Group Policy setting that automatically redirects a user’s Desktop, Documents, and Pictures folders to OneDrive. When the policy is applied but folders stay local, one of these conditions is true: the policy has not reached the client, the OneDrive client version is too old, the user has already redirected folders manually, or a prerequisite like the OneDrive sync app is not installed. The policy only works if the user is signed into OneDrive with a work or school account and the client version is 19.002.0107.0006 or newer. If any of these conditions are missing, the policy appears applied but does nothing.

Group Policy Processing Order

Group Policy applies in a specific order: local, site, domain, and then organizational unit. If a conflicting policy exists at a higher level, it can override the KFM policy. Additionally, KFM policies are user-based, so they only apply when a user logs in. If the user is already logged in when the policy is assigned, they must log out and log back in.

OneDrive Client Requirements

The OneDrive sync app must be running and signed in. The policy does not install the app. If the user has never signed into OneDrive, the policy waits until they do. Once signed in, OneDrive checks for the policy during the next sync cycle, which can take up to 8 hours if the user does not restart the app.

Steps to Force Known Folder Move to Apply

1. Verify the policy is correctly configured
   Open Group Policy Management Console on a domain controller. Locate the GPO containing your KFM setting. Navigate to Computer Configuration > Administrative Templates > OneDrive. Double-click “Redirect known folders to OneDrive.” Ensure it is set to “Enabled” and the option “Redirect the Desktop, Documents, and Pictures folders” is selected. Link the GPO to the correct organizational unit containing the target users.
2. Force a group policy update on the client
   On the user’s Windows device, open Command Prompt as administrator. Run gpupdate /force. Wait for the command to complete. Then sign the user out of Windows and back in. This ensures the policy is read during user logon.
3. Check the OneDrive client version
   Right-click the OneDrive cloud icon in the notification area and select Settings. Go to the About tab. The version must be 19.002.0107.0006 or higher. If it is older, download the latest version from the Microsoft 365 admin center or install it via Intune.
4. Sign the user into OneDrive
   If the user is not signed in, open OneDrive from the Start menu. Enter the user’s work or school email address and complete the sign-in process. After signing in, OneDrive checks for the KFM policy within 15 minutes. You can speed this up by restarting the OneDrive process: right-click the cloud icon, select Quit OneDrive, then launch OneDrive again from the Start menu.
5. Manually trigger folder redirection
   If the policy still does not move folders, open OneDrive Settings > Sync and backup > Manage backup. Click the Update folders button. This forces OneDrive to apply the policy immediately. The Desktop, Documents, and Pictures folders will begin moving to OneDrive.
6. Verify redirection in File Explorer
   After the sync completes, open File Explorer. Right-click the Desktop, Documents, or Pictures folder under This PC and select Properties > Location. The path should show C:\Users\username\OneDrive - TenantName\Desktop (or Documents, Pictures). If the path still shows the local profile folder, the redirection did not take effect.

If OneDrive Still Leaves Folders Local

OneDrive shows “Redirect your known folders” but does nothing

This happens when the policy is detected but the user has previously redirected folders manually and then removed them. OneDrive remembers the previous state. To reset the state, delete the registry key HKCU\Software\Microsoft\OneDrive\Accounts\Business1\KnownFolderMove and then repeat step 5.

Folder redirection starts but fails halfway

The most common cause is a file name that exceeds the 255-character limit. OneDrive cannot sync files with paths longer than 400 characters. Open the local folder and move or rename any files with long paths. You can use the OneDrive sync client log file at %localappdata%\Microsoft\OneDrive\logs to identify the exact file causing the failure.

Policy applies only to new users

By default, KFM policy applies to all users in the organizational unit, including existing users. If it only applies to new users, check that the policy is not set to “Apply once and do not reapply.” In the Group Policy Management Editor, double-click the KFM policy setting. Ensure the option “Apply the policy to all existing users” is selected. If it is not, the policy only affects users who sign in for the first time after the policy is applied.

OneDrive client says “Your organization manages this setting” but folders are local

This message appears when the policy is recognized but the user has not given consent. Open OneDrive Settings > Sync and backup > Manage backup. If a yellow banner appears asking for permission, click Allow. The folders will then move.

Item	Policy Applies Immediately	Policy Applies After Logon
Trigger	User logs in while policy is active	Policy assigned while user is logged in
Client action	OneDrive redirects folders within 15 minutes	User must sign out and sign in, or run gpupdate /force
Verification	Check folder location in File Explorer	Check folder location after next logon
Common failure	OneDrive not signed in	GPO not linked to correct OU

You can now diagnose and resolve the issue where a KFM policy is applied but documents remain local. Start by verifying the policy configuration and forcing a group policy update on the client device. If the problem persists, check the OneDrive client version and manually trigger folder redirection through the Manage backup settings. An advanced tip: use the OneDrive policy report in the Microsoft 365 admin center under Health > OneDrive to see which users have successfully redirected their folders and which have not.