sodcalculator

10 Tech How-To

Fix OneDrive Sync Pending Stuck in Windows 10

Guide 10-54661 · Updated · Step by step

If OneDrive on Windows 10 is stuck showing “Sync pending” and files won’t upload or download, the fix usually involves pausing and resuming sync, restarting the OneDrive process, or clearing the sync cache. Below are the exact steps to resolve the most common causes, from simple restarts to deeper resets.

Why OneDrive Gets Stuck on “Sync Pending”

OneDrive shows “Sync pending” when it has detected a file change but hasn’t yet processed it. This can happen for many reasons: a temporary network glitch, a file that is open in another program, a corrupted sync database, or a conflict with another cloud sync tool. Windows 10’s OneDrive client (the built-in UWP version and the standalone sync app) both use a local cache to track file states. When that cache gets out of sync with the server, the pending status can persist indefinitely.

Common triggers include:

  • Files with invalid characters or names that are too long (over 255 characters).
  • Files locked by another process (e.g., an open Word document or a database file).
  • OneDrive running with corrupted cache files after a system crash or forced shutdown.
  • Network changes (switching Wi-Fi, VPN, or proxy) that interrupt the sync session.
  • Third-party antivirus or backup software that locks files while OneDrive tries to read them.
  • OneDrive app version bugs, especially after a Windows 10 feature update.

Quick Fixes to Try First

Start with these low-risk steps. They resolve most pending issues without touching your files.

  1. Pause and resume sync: Right-click the OneDrive cloud icon in the system tray (near the clock), select “Pause syncing” and choose a duration (2 hours, 8 hours, or 24 hours). After the pause elapses, or when you manually resume via the same menu, OneDrive will re-scan the folder.
  2. Restart OneDrive: Right-click the cloud icon, choose “Exit.” Then open Start, type “OneDrive” and press Enter. This restarts the process with a fresh session.
  3. Restart your PC: A full reboot clears temporary file locks and resets network adapters. After reboot, check if the pending status clears.
  4. Check file names: Rename any file that contains characters like < > : " / \ | ? * or trailing periods/spaces. Also shorten very long paths.
  5. Close open files: Ensure no file in the OneDrive folder is open in any program, including Office apps, PDF readers, or media players.

Reset OneDrive Sync (Without Deleting Files)

If quick fixes fail, resetting the OneDrive sync engine is the next step. This rebuilds the local sync database but does not delete any files from your PC or the cloud.

  1. Press Windows + R to open the Run dialog.
  2. Type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset and press Enter. (For the Microsoft Store version, the path may be %localappdata%\Microsoft\WindowsApps\OneDrive.exe /reset.)
  3. A command prompt window may flash briefly. Wait for the OneDrive icon to reappear in the system tray (usually within a minute).
  4. If the icon doesn’t appear, launch OneDrive manually from Start.
  5. After reset, OneDrive will re-scan your folder and re-download metadata. Pending statuses should clear.

If the reset doesn’t help, you can unlink and relink your account:

  1. Right-click the cloud icon, select Settings > Account tab > Unlink this PC.
  2. Confirm, then sign in again with your Microsoft account.
  3. Choose the folders you want to sync. This does not delete cloud files; it only re-establishes the connection.

Clear the OneDrive Cache Manually

When a reset doesn’t work, the cache files themselves may be corrupted. Clearing them forces OneDrive to rebuild everything from the server.

  1. Exit OneDrive completely (right-click icon > Exit).
  2. Press Windows + R, type %localappdata%\Microsoft\OneDrive\ and press Enter.
  3. Delete the contents of the cache folder (if present). Also delete the settings and logs folders inside that directory.
  4. Restart OneDrive. It will re-scan your folder and download fresh metadata. Your local files remain untouched.

Note: If you have Files On-Demand enabled, clearing the cache may cause files to show as online-only placeholders temporarily. They will re-download as you access them.

Check for File Conflicts and Folder Permissions

Sometimes “Sync pending” is caused by a file that OneDrive cannot read due to permissions or a conflict. Look for files with names like “name (1).docx” or “name (user’s conflicted copy)”. These are conflict copies that OneDrive creates when a file changes on two devices simultaneously. You can safely delete or merge these copies.

Also verify that the OneDrive folder location has proper read/write permissions. Right-click the OneDrive folder in File Explorer, select Properties > Security, and ensure your user account has “Full control”. If not, click Edit and grant it.

Network and Antivirus Interference

OneDrive relies on a stable connection to Microsoft servers. If you use a VPN, proxy, or a firewall that blocks certain ports, sync can stall. Temporarily disable VPN or proxy and test. Also, some antivirus programs (especially those with real-time file scanning) can lock files that OneDrive is trying to upload. Add the OneDrive folder to the antivirus exclusion list, or temporarily disable real-time protection to test.

Check Windows 10 network settings: go to Settings > Network & Internet > Status and run the “Network troubleshooter”. Also, ensure your system date and time are correct, as incorrect time can cause authentication failures.

Update or Reinstall OneDrive

Microsoft regularly updates the OneDrive client. An outdated version may have bugs that cause pending loops.

  1. Right-click the cloud icon, select Settings > About tab. The version number is shown there.
  2. Visit the official OneDrive download page and install the latest version (it will overwrite the existing installation).
  3. If problems persist, uninstall OneDrive via Settings > Apps > Apps & features, then reinstall from the Microsoft Store or the official site. Your files remain in the cloud and on disk.

Frequently Asked Questions

Will resetting OneDrive delete my files?

No. Resetting or unlinking OneDrive only rebuilds the local sync database and re-establishes the connection. Your files remain in the cloud and on your PC. The only exception is if you choose “Free up space” which removes local copies but keeps them online.

Why does OneDrive show “Sync pending” for a file that is not open?

This often happens due to a corrupted cache entry or a file lock from a background process (like antivirus scanning). The reset or cache-clearing steps above usually fix it. If not, the file itself may have a name that violates OneDrive’s rules; rename it.

Can I force OneDrive to sync immediately?

Yes. Right-click the cloud icon and select “Resume syncing” if it’s paused. You can also press Shift + F10 on a selected file in the OneDrive folder and choose “Force sync” (this option appears in some versions). Alternatively, restart OneDrive to trigger a rescan.

Does OneDrive sync pending affect other devices?

Yes, if one device is stuck, changes made on that device won’t upload, so other devices won’t see them. Fixing the pending status on that device resolves the issue. Other devices continue to sync their own changes normally.

What if the OneDrive icon is missing from the system tray?

Click the up arrow (show hidden icons) in the taskbar. If it’s still not there, search for “OneDrive” in Start and launch it. If it doesn’t start, run the reset command as described above.

Is there a way to avoid pending status in the future?

Keep your OneDrive app updated, avoid using special characters in file names, close files before shutting down, and ensure your network is stable. Also, periodically restart OneDrive if you notice it slowing down.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →