Fix OneDrive Sync Stuck on Processing Changes or Sync Pending
OneDrive shows Processing changes for hours or a red X on files? Check file names and path length, reset the client and relink your account.
Common Symptoms and Quick Fixes
| Symptom | Likely Cause | Quick Fix |
|---|---|---|
| Processing changes forever | Large folder scan or corrupted cache | Reset OneDrive |
| Red X on one file | Invalid characters or path too long | Rename the file and shorten the path |
| Sync pending on every file | Account or quota issue | Unlink and relink the PC; check storage |
Method 1: Check Names, Path Length and File Size
OneDrive refuses items that break these rules.
1
Illegal charactersFile names cannot contain ” * : < > ? / \ | and cannot start or end with a space.
2
Path lengthKeep the full path under 400 characters. Move deep folders closer to the root.
3
File sizeSingle files over 250 GB cannot sync.
Method 2: Reset the OneDrive Client
A reset does not delete your files. It only rebuilds the sync database. Press Win + R and run the first command; if nothing happens, use the second.
%localappdata%\Microsoft\OneDrive\onedrive.exe /reset
"C:\Program Files\Microsoft OneDrive\onedrive.exe" /reset4
Wait, then start OneDriveGive it a minute. If the icon does not return, press Win + R and run %localappdata%\Microsoft\OneDrive\onedrive.exe.
Method 3: Unlink and Relink the PC
OneDrive icon > Settings > Account > Unlink this PC. Sign in again and choose the same folder; existing files are matched and not downloaded twice.
Method 4: Check Storage Quota
Open onedrive.com > Manage storage. A full quota stops uploads and shows Sync pending.
Pro Tip for AdministratorsRight-click a large folder and choose Free up space to keep files online only.
Frequently Asked Questions (FAQ)
Q: Will the reset delete my files?
No. Local and cloud files stay in place.
Q: Why is a file synced on one PC but not another?
Usually a name or path problem on the failing PC. Compare the folder depth.