sodcalculator

10 Tech How-To

Fix OneDrive Sync Problems on Windows 10

Guide 10-53909 · Updated · Step by step

OneDrive sync problems on Windows 10 usually come from a paused sync, a corrupted cache, or a conflict with another program, and most can be fixed by restarting the app or resetting it. This guide walks through the common causes and step-by-step fixes, from simple resets to more advanced troubleshooting.

Why OneDrive Sync Stops Working

OneDrive on Windows 10 is a background app that watches a folder and uploads or downloads changes. When it stops, the cause is often one of these:

  • Sync paused – either manually or automatically (e.g., during a metered connection or battery saver).
  • File lock – a file is open in another program, so OneDrive can’t upload it.
  • Corrupted cache – the local database that tracks file states gets out of sync.
  • Conflicting software – antivirus, VPN, or another cloud sync tool interferes.
  • Account or license issue – the sign-in token expired or the storage quota is full.
  • Windows update or driver problem – a recent update can break the sync engine.

Quick Fixes to Try First

Before diving into resets, try these simple steps – they resolve many issues in under a minute.

  1. Check the OneDrive icon in the system tray (bottom-right). If it shows “Paused,” click it and select “Resume syncing.”
  2. Restart OneDrive – right-click the cloud icon, choose “Exit,” then start OneDrive from the Start menu.
  3. Restart your PC – this clears temporary glitches and releases locked files.
  4. Check your internet connection – a weak or metered connection can pause sync automatically.
  5. Make sure you have enough storage – go to OneDrive on the web and check your quota.

If none of these work, move on to the more thorough fixes below.

Reset OneDrive (Without Deleting Files)

Resetting OneDrive clears the local cache and re-establishes the sync relationship without deleting your files. This is the most effective fix for a stuck sync.

  1. Press Windows + R to open the Run dialog.
  2. Type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset and press Enter. (If you’re using the Microsoft Store version, the path is %localappdata%\Microsoft\WindowsApps\OneDrive.exe /reset.)
  3. Wait about a minute – the OneDrive icon should reappear in the system tray. If it doesn’t, start OneDrive manually from the Start menu.
  4. Sign in again if prompted. Your files will re-sync from the cloud, which may take a while depending on how many you have.

This does not delete your files – it only rebuilds the local sync database. Your files remain on the cloud and on your PC.

Fix File-Specific Sync Errors

If only certain files won’t sync, OneDrive shows a red circle or a “Sync error” message. Common causes and fixes:

  • File name too long – Windows has a 260-character path limit. Rename the file or move it to a shorter path.
  • Invalid characters – OneDrive doesn’t allow " * : < > ? / \ | in file names. Remove them.
  • File is locked – close the file in any open program (Word, Excel, etc.) and try again.
  • File is too large – the default limit is 250 GB per file (for OneDrive). If you’re over, compress or split the file.
  • File is open in another device – if you’re editing on another computer, OneDrive may wait for it to close.

Clear the OneDrive Cache Manually

If resetting doesn’t help, you can manually delete the cache folder. This is a bit more aggressive but still safe – your files are in the cloud.

  1. Right-click the OneDrive icon and choose “Settings” → “Account” → “Unlink this PC.”
  2. Press Windows + R, type %localappdata%\Microsoft\OneDrive\cache and delete the contents (or the whole folder).
  3. Reopen OneDrive and sign in again. It will rebuild the cache and re-sync.

Do not delete the OneDrive folder itself – that would remove your local files. Only the cache folder is safe to clear.

Check for Conflicting Software

Antivirus programs, VPNs, and other cloud sync tools (like Dropbox or Google Drive) can interfere with OneDrive’s file monitoring. To test:

  • Temporarily disable your antivirus – if sync works, add OneDrive to the exclusion list.
  • Disconnect your VPN – VPNs can break the connection to Microsoft servers.
  • Close other sync apps – they may lock the same files.

If the problem only happens when a specific program is running, that’s the culprit. Keep that program closed or adjust its settings.

When to Use the OneDrive Troubleshooter

Microsoft provides a built-in troubleshooter for OneDrive that can automatically detect and fix common issues.

  1. Open Settings (Windows + I) → Update & Security → Troubleshoot → Additional troubleshooters.
  2. Select OneDrive and run the troubleshooter.
  3. Follow the on-screen instructions. It may reset OneDrive or repair the installation.

If the troubleshooter doesn’t find anything, try reinstalling OneDrive: uninstall it from Settings → Apps, then reinstall from the Microsoft Store or the OneDrive website. Your files are safe – they’re in the cloud.

Frequently Asked Questions

Why is OneDrive stuck on “Processing changes”?

This usually means OneDrive is scanning a large number of files or a file is locked. Wait a few minutes – if it persists, reset OneDrive as described above. Also check that no files are open in another program.

Does resetting OneDrive delete my files?

No. Resetting only clears the local cache and sync database. Your files remain on your PC and in the cloud. After reset, OneDrive re-downloads or re-uploads as needed.

How do I stop OneDrive from syncing a folder?

Right-click the OneDrive icon → Settings → Account → “Choose folders.” Uncheck the folders you don’t want to sync. They’ll remain in the cloud but not on your PC.

Why does OneDrive show a red circle with a white X?

That means a sync error for a specific file. Click the icon to see the error message. Common fixes: rename the file to remove invalid characters, shorten the path, or close the file if it’s open.

Can I use OneDrive on a metered connection?

Yes, but Windows may pause sync automatically to save data. You can override this in OneDrive Settings → Network, and check “Sync automatically” even on metered networks, but be aware it will use your data allowance.

What if OneDrive won’t start at all?

Try running the reset command again, then start OneDrive manually. If it still won’t start, reinstall the app. Also check that the OneDrive service is running: press Windows + R, type services.msc, find “OneDrive Updater Service” (or similar) and ensure it’s set to Automatic and running.

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 →