sodcalculator

10 Tech How-To

OneDrive Stuck on Processing Changes: Fixes

Guide 10-12377 · Updated · Step by step

When Microsoft OneDrive gets stuck on “Processing changes,” it usually means the sync engine is caught in a loop trying to reconcile file changes, often due to a large number of files, a corrupted cache, or a conflict with another program. This guide walks you through the most effective fixes, from simple pauses to resetting the sync client, so you can get your files syncing again without losing data.

What You’ll Need

  • Administrator access to your Windows PC or Mac (to reset OneDrive or edit registry keys on Windows).
  • Your Microsoft account credentials (you’ll need to sign in again after a reset).
  • Patience: some steps, like a full reset, can take a few minutes.

Step-by-Step

  1. Pause and Resume Syncing
    Right-click the OneDrive cloud icon in the system tray (Windows) or menu bar (Mac). Select “Pause syncing” and choose a duration (2, 8, or 24 hours). Wait a few seconds, then right-click again and select “Resume syncing.” This often clears a temporary hiccup.
  2. Restart OneDrive
    If pausing doesn’t help, quit OneDrive completely. Right-click the cloud icon and select “Quit OneDrive” (Mac) or “Exit” (Windows). Then reopen it from the Start menu or Applications folder. This forces the sync engine to start fresh.
  3. Check for Large Files or Many Files
    OneDrive can struggle with thousands of small files or a single file over 15GB. Open your OneDrive folder and look for any file that’s still showing a sync icon (like a green checkmark missing). Move extremely large files out of the folder temporarily, or break up a folder with too many files into smaller subfolders.
  4. Clear the OneDrive Cache
    If restarting doesn’t work, the local cache may be corrupted. Close OneDrive, then open File Explorer and navigate to %localappdata%\Microsoft\OneDrive\ (Windows) or ~/Library/Application Support/OneDrive/ (Mac). Delete the contents of the logs and settings folders (but not the folders themselves). Restart OneDrive and let it re-sync.
  5. Reset OneDrive
    This is the most reliable fix. On Windows, press Win + R, type onedrive.exe /reset, and press Enter. A command prompt window will flash, and OneDrive should restart. On Mac, open Terminal and run killall OneDrive then ~/Applications/OneDrive.app/Contents/MacOS/OneDrive &. If it doesn’t restart automatically, start it manually.
  6. Unlink and Relink Your Account
    If a reset doesn’t work, unlink your account. Right-click the cloud icon, go to Settings (or Preferences on Mac), then the Account tab, and click “Unlink this PC.” Sign back in, and OneDrive will rebuild its sync database. This is more thorough than a reset.
  7. Check for File Name or Path Issues
    OneDrive cannot sync files with invalid characters (like " : * ? < > |) or names that exceed 255 characters. Look for files with red or yellow icons in your OneDrive folder, rename them, and see if the processing stops.
  8. Disable Files On-Demand Temporarily
    If you use Files On-Demand, right-click the cloud icon, go to Settings, and under the Sync tab, uncheck “Save space and download files as you use them.” Apply, wait a minute, then re-enable it. This can refresh the placeholder state.
  9. Update or Repair Office/OneDrive
    An outdated OneDrive client can cause sync loops. Go to Settings > Account > About, and check for updates. On Windows, you can also go to Settings > Apps > Microsoft OneDrive > Advanced Options > Repair (or Reset) to fix a broken installation.

Common Mistakes

  • Deleting the cache folder entirely – This can cause OneDrive to re-download everything, making the problem worse. Always delete contents, not the folder itself.
  • Not quitting OneDrive before clearing cache – If OneDrive is still running, it will overwrite your changes. Always quit completely first.
  • Ignoring file name errors – OneDrive will keep retrying to sync a problematic file, blocking the entire queue. Fix the file name first.
  • Using a VPN or proxy – A VPN can interrupt the sync connection, causing endless “processing”. Temporarily disable it and see if that helps.

Tips

  • Let it run overnight – If you have a huge backlog, “Processing changes” can legitimately take hours. Leave the computer on and connected to power.
  • Keep your OneDrive folder on the same drive as Windows – Moving it to an external drive can cause sync issues.
  • Use selective sync – If you have more than 100,000 files, consider syncing only the folders you need most.
  • Regularly restart OneDrive – A weekly restart can prevent buildup of temporary glitches.

Troubleshooting

If the steps above don’t resolve the issue:

  • Check the OneDrive support site – Microsoft’s service health dashboard will show if there’s an ongoing outage. If so, wait and don’t make changes.
  • Run the OneDrive diagnostic tool – On Windows, go to Settings > Account > About, and click “Run diagnostic” (if available). It will test for common issues.
  • Check for third-party conflicts – Antivirus software or backup tools can lock files and interfere with OneDrive. Temporarily disable them (especially real-time scanning) to test.
  • Create a new Windows user profile – If the problem persists, your user profile may be corrupted. Create a test user account and try syncing there. If it works, you’ll need to migrate your files.
  • Use the web app – As a temporary workaround, access your files via the OneDrive website to confirm they’re safe, and upload new files there until the desktop client is fixed.

Frequently Asked Questions

Will resetting OneDrive delete my files?

No. Resetting or unlinking only removes the local sync configuration. Your files remain in the cloud and on your hard drive, and OneDrive will re-sync them after you sign back in.

How long should “Processing changes” take?

For a few hundred files, it should clear within minutes. For tens of thousands of files, it can take several hours. If it lasts more than 24 hours, try the reset steps.

Why does OneDrive get stuck after a big file move?

Moving a large folder or many files at once can overwhelm the sync engine. It’s better to move files in smaller batches and let OneDrive catch up.

Can I safely delete the OneDrive cache?

Yes, but only the contents of the logs and settings folders. Do not delete the cache folder itself, as that can force a full re-download.

Does this happen on Mac too?

Yes, Mac users can experience the same issue. The fix is similar: quit OneDrive, clear the cache in ~/Library/Application Support/OneDrive/, and restart.

What if OneDrive is stuck but the files are already synced?

Sometimes the status is just a visual glitch. Right-click the cloud icon and select “Refresh” (if available), or restart OneDrive to clear the stale status.

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 →