OneDrive Desktop, Documents, and Pictures Folders Not Syncing

When your Desktop, Documents, and Pictures folders stop syncing with OneDrive, files saved to your computer’s primary working directories fail to upload to the cloud. Status icons disappear or display persistent red badges, changes made on one PC do not propagate to other devices, and these standard Windows folders point to disconnected local directories rather than the active OneDrive sync root.

Fast Fix:
Reconfigure Known Folder Move (KFM) folder backup. Open OneDrive Settings (gear icon) > Sync and backup > Manage backup. Toggle the switches for Desktop, Documents, and Pictures to On, then click Save changes. If Windows reports a path redirection error or policy block, reset the OneDrive client and restore the default shell folder paths.

Diagnostic Snapshot

  • Direct Causes: Disabled folder backup (Known Folder Move), registry user shell folder path misconfigurations, permission locks on local profile roots, or third-party cloud tools hijacking directory pointers.
  • Risk Level: Moderate. Files stored only in unmapped local directories (C:\Users\<Username>\) will not back up to Microsoft 365 and can be lost if hardware fails before sync is restored.
  • Scope: Local Windows Known Folder redirection; existing cloud files remain safe and accessible via OneDrive for Web.

Why Desktop, Documents, and Pictures Folders Stop Syncing

Windows uses an architectural feature called Known Folder Move (KFM) to point default system user folders (%USERPROFILE%\Documents, %USERPROFILE%\Desktop, %USERPROFILE%\Pictures) to the corresponding subfolders inside the OneDrive directory structure (%USERPROFILE%\OneDrive - Tenant\Documents).

This synchronization redirection breaks down when:

  1. Broken User Shell Folder Registry Pointers: If the Windows User Shell Folders registry key points to legacy non-OneDrive paths or contains hardcoded absolute paths that don’t match the active user environment, Windows defaults back to disconnected local folders.
  2. Special Application Locks (e.g., Outlook .pst or OneNote files): Microsoft prevents Known Folder Move from redirecting the Documents folder if it contains local Outlook .pst data files or active OneNote notebook sections that are incompatible with cloud sync engines.
  3. Storage Quota Blocks: If your OneDrive cloud storage is full, the client disables backup redirection for new files.
  4. Third-Party File Hijacking: Competing backup utilities (such as iCloud Drive, Dropbox, or Google Drive) or aggressive disk cleanup tools alter folder redirection parameters, triggering directory tracking failures.

Step-by-Step Resolution Path

Follow these troubleshooting steps in order, moving from standard client backup configuration to file-block checks, registry repairs, and client resets.

1. Re-enable Folder Backup in OneDrive Settings
Force the OneDrive client to re-evaluate its folder redirection:

  1. Click the OneDrive cloud icon in the system tray.
  2. Select the gear icon (Settings) and choose Settings.
  3. In the left navigation, click Sync and backup, then click Manage backup.
  4. Check the toggles for Desktop, Documents, and Pictures.
  5. Click Save changes.
  6. If an error dialog appears (e.g., “The folder contains unsupported files” or “This folder can’t be protected”), take note of the specific file named in the prompt.

2. Remove Incompatible Files from the Target Folders
Certain file formats and deeply nested paths block folder redirection:

  • Outlook .pst Files: Move any local Outlook archive files out of C:\Users\<Username>\Documents to a non-synced folder such as C:\Data\Outlook\.
  • OneNote .one Files: Open the desktop OneNote app, export notes properly to cloud notebooks, and delete un-synced raw .one cache files from Documents.
  • Symlinks and Junction Points: Remove any custom directory shortcuts (junctions) placed inside Desktop or Documents.
  • Long Paths: If a file within these directories exceeds character ceilings, it blocks the entire folder backup queue.

3. Repair Windows User Shell Folder Registry Keys
If the “Manage Backup” menu states that your folders are redirected elsewhere or settings fail to save, restore default registry values:

  1. Press Windows Key + R, type regedit, and press Enter.
  2. Navigate to the following path:Plaintext HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders
  3. Locate the string values for the affected folders:
    • Desktop: Should be set to %USERPROFILE%\Desktop (or %USERPROFILE%\OneDrive\Desktop when synced).
    • Personal (Documents): Should be set to %USERPROFILE%\Documents (or %USERPROFILE%\OneDrive\Documents).
    • My Pictures: Should be set to %USERPROFILE%\Pictures (or %USERPROFILE%\OneDrive\Pictures).
  4. If the string data points to a corrupted or non-existent path, double-click the entry, set it to the default %USERPROFILE%\<FolderName>, and click OK.
  5. Restart your PC, launch OneDrive, and run Manage backup again.

4. Reset the OneDrive Sync Client Cache
When the local sync catalog contains invalid redirection GUIDs, executing a client reset restores normal sync mapping without affecting your personal documents.

  1. Press Windows Key + R to open the Run dialog box.
  2. Paste the following reset command and press Enter:DOS %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  3. The OneDrive icon will disappear from your taskbar. Allow up to 2 minutes for the client to restart. If it does not reappear automatically, run:DOS %localappdata%\Microsoft\OneDrive\onedrive.exe