onedrive

OneDrive Not Syncing

Resolution Checklist

  • 1 Understand OneDrive sync status icon indicators
  • 2 Perform initial basic account and network checks
  • 3 Reset OneDrive sync engine on Windows (Command Prompt)
  • 4 Rebuild FileProvider connections and reset OneDrive on macOS
  • 5 Unlink and relink credentials to force a full re-index

OneDrive Not Syncing

When Microsoft OneDrive is not syncing, files won’t update between your local folder and the cloud. The application may display status messages like “Stuck on Processing Changes”, “Sync Pending”, or simply stall in the menu bar with no activity.

This comprehensive guide details how to identify the sync error using status icon guides and execute steps to repair the sync engine on both Windows and macOS.

Step 1: Decode OneDrive Sync Status Icons

Before running terminal commands, inspect the status icon on the file or the OneDrive cloud icon in your menu bar (Mac) or system tray (Windows):

  • Blue Cloud (Outlined): File is online-only. Takes up 0KB locally, but is accessible.
  • Green Checkmark (White Circle): File is temporarily downloaded to local storage (Files On-Demand). Can revert to online-only if disk space runs low.
  • Green Checkmark (Solid Circle): File is permanently pinned to local storage (“Always keep on this device”).
  • Two Blue Arrows in a Circle: Syncing is actively in progress. If this spins for hours with no byte changes, sync is stuck.
  • Red Circle with White Cross: An active error has blocked sync. Click the cloud icon to inspect the file conflicts.
  • Yellow Warning Triangle: Indicates an account action is required (e.g., storage full, update payment details, or password expired).

Step 2: Perform Initial Account & Directory Audits

Verify these basic properties before executing application resets:

  1. Verify Free Disk Space: OneDrive requires at least 200MB to 1GB of free buffer disk space. If your C: drive or Mac APFS volume is completely full, the database locks.
  2. Inspect Web Portal Credentials: Log in to OneDrive Web Portal. If you can access it and upload a mock file, the cloud server is operational, and the issue is restricted to your local client.
  3. Check for Forbidden Characters: File names must not contain special character strings such as *, ?, :, <, >, |, /, or \.

Step 3: Repair & Reset OneDrive on Windows

If OneDrive remains stuck on Windows, the local cache database has likely entered a locked state. Follow these procedures to clear it:

1. Close and Restart the OneDrive Process

  1. Right-click the Start menu and select Command Prompt (Admin) or Terminal.
  2. Type the following command to terminate any locked OneDrive instances: 
    taskkill /f /im onedrive.exe
  3. Open the Start menu, type OneDrive, and launch it to force a cold re-index.

2. Reset the OneDrive Local Database

Resetting clears all app caches and starts a clean sync check. It does not delete your downloaded files.

  1. Press Windows Key + R to open the Run window.
  2. Copy and paste the command below, then press Enter: 
    %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  3. If Windows displays a “cannot find” error, run this command instead: 
    C:\Program Files\Microsoft OneDrive\onedrive.exe /reset
  4. Wait 60 seconds, then search for OneDrive in the Start menu and launch it.

Step 4: Repair & Reset OneDrive on macOS

On modern versions of macOS (Monterey, Ventura, Sonoma, and Sequoia), OneDrive utilizes Apple’s native FileProvider framework. If the daemon stalls, syncing halts.

1. Enable Finder Extensions

If sync icons are missing:

  1. Open macOS System Settings.
  2. Search for Extensions and select Finder Extensions.
  3. Ensure the checkbox for OneDrive Finder Integration is ticked.

2. Force Restart Apple FileProvider

  1. Open the Terminal utility (via Spotlight search).
  2. Kill the file system sync daemon by typing: 
    killall -9 fileproviderd
  3. macOS will immediately respawn the daemon, resetting the sync tunnels for all mounted cloud volumes.

3. Reset the macOS OneDrive Cache

  1. Open Finder, navigate to your Applications folder.
  2. Right-click the OneDrive app icon and select Show Package Contents.
  3. Expand Contents → Resources.
  4. Double-click the file named ResetOneDriveAppStandalone.command.
  5. This opens a Terminal window that clears the sync configurations and prompts you to sign back in.

If file caches remain out of alignment, unlinking your profile resets the connection profile.

  1. Click the OneDrive Cloud Icon in your system tray or menu bar.
  2. Select Settings (Gear Icon) → Settings.
  3. Under the Account tab, click Unlink this PC (or Unlink this Mac).
  4. Reboot your machine.
  5. Launch OneDrive, type in your Microsoft login credentials, and select your target sync folder to begin clean file matching.