When OneDrive won’t sync, check connection, sign-in, storage, and file limits, then run a reset to force a fresh sync.
If you opened your laptop and changes never reached the cloud, you’re in the place. This guide gives clear checks, fast fixes, and deeper cures for stubborn sync errors on Windows and macOS. You’ll learn what to try first, why it works, and when a full reset saves the day.
Fast Checks That Clear Most Sync Glitches
Start with the items below. They take minutes and solve a big share of cases:
- Internet working? Visit a site in the browser or toggle Wi-Fi off and on.
- Signed in to the right account? Work and personal libraries don’t mix.
- Enough cloud and disk space? Free space on both ends to keep changes moving.
- Pause off? If OneDrive is paused, resume syncing from the tray icon.
- VPN or firewall? Temporarily disable, or allow OneDrive traffic.
- Latest app build? Update the client; new builds often fix sync logic.
Common Causes And Tell-Tale Symptoms
Different issues leave different clues. Match your symptom to a cause in the table, then jump to the fix.
| Symptom | Likely Cause | Where To Start |
|---|---|---|
| Blue arrows spin forever | App stuck or offline | Restart app, check network |
| Red X on files | Limits hit or access denied | Check name/length/permissions |
| “Processing changes” for hours | Huge queue or lock files | Close apps, wait for batch |
| Some folders never appear | Selective sync filter | Update folder choices |
| Grey cloud icon | Signed out or paused | Sign in and resume |
| Stuck on one file | Invalid characters or temp files | Rename or exclude |
| Frequent “conflicted copy” | Edits on two devices | Pick a source, merge edits |
OneDrive Not Syncing Fixes You Can Try
Work from top to bottom. Stop once syncing resumes.
1) Restart The App And The Box
Quit OneDrive from the tray or menu bar, then relaunch it. A fast reboot clears stale credentials, paused jobs, and hung background tasks.
2) Confirm Account And Libraries
Open settings and check the account tab. Make sure the right tenant is active and the correct folders are selected. If a library was removed or your permission changed, the client can’t fetch it.
3) Fix Storage Mismatch
Open the web view and delete items in the recycle bin. Empty large local temp folders. Leave at least a few gigabytes free on the system drive so the client can stage files.
4) Repair Name, Path, And File Limits
OneDrive enforces path length, invalid characters, and some special file types. Long nested folders, trailing spaces, or names ending with a period can block uploads. Shorten deep paths, remove special characters, and avoid temporary files created by other apps.
5) Turn Off Files Open In Other Apps
Word, Excel, or your PDF reader can lock items during editing. Close the app, wait a few seconds, then watch the cloud icon. If the queue clears, the lock was the culprit.
6) Clear Stuck Credentials
Sign out of OneDrive and sign back in. On Windows, remove old entries from Credential Manager; on macOS, remove saved items from Keychain Access. Then add the account again.
7) Rebuild The Local Cache
The client can be reset without losing files in the cloud. A reset disconnects and rebuilds the local database, which resolves many stubborn states.
Deep Fixes For Persistent Errors
Reset The Client On Windows
Press Win + R, paste %localappdata%\\Microsoft\\OneDrive\\onedrive.exe /reset, and press Enter. The cloud icon disappears, then returns within a minute. If it doesn’t, run OneDrive from the Start menu. This reset keeps your files in place and triggers a full re-scan.
Reset On macOS
Quit OneDrive. Open Terminal and run ~/Applications/OneDrive.app/Contents/MacOS/OneDrive /reset. If the app doesn’t relaunch, open it from Applications. Sign in again if prompted, then let the scan complete.
Repair Or Reinstall
On Windows, open Apps & Features, select Microsoft OneDrive, and choose Repair. If that fails, uninstall and install the current build. On macOS, drag the app to Trash, download the latest package, and install fresh. Re-add your account and choose folders again. After reinstall, wait for the first scan to settle before moving large folders or renaming big trees.
Check Service Health
Occasional outages block sign-in or slow the queue. When sync stops across multiple devices, confirm the status before changing settings. Visit Microsoft’s service health dashboard and scan for incidents.
Rules And Limits That Commonly Block Sync
Many “mystery” errors come from limits. Fix the name or path and the upload will finish.
- Path length: Deep nesting can exceed the combined limit. Flatten folder depth and shorten long names.
- Invalid characters: Avoid *, :, ?, <, >, |, and names ending with a period or space.
- File types: Some admin policies block certain extensions. Company rules override local settings.
- Size and number caps: Very large files or massive batches can take time. Let the queue finish or split the move.
Selective Sync And Storage Sense Settings
Selective sync controls which folders live on the device. If a folder is unticked, it stays online-only and won’t appear locally. On Windows, also check Storage Sense or Files On-Demand settings. If the system frees local space, files may show as cloud-only until opened.
Fix Missing Folders With Folder Selection
- Open OneDrive settings.
- Open the Account tab and choose Choose folders.
- Tick the folders you need on the device.
Network And Security Items To Review
Corporate firewalls, DNS filters, and proxy settings can throttle or block sync. If you’re at home, test on a phone hotspot to confirm the path is clear. If the hotspot works, the router or ISP is the bottleneck. For work devices, ask IT for the allow list used for Microsoft 365 endpoints.
Mac-Specific Tips
Grant Full Disk Access to OneDrive in System Settings > Privacy & Security. Keep the app in Login Items so it relaunches after a restart. If Finder overlays are missing, restart Finder from Force Quit and relaunch OneDrive.
Windows-Specific Tips
In Settings > Accounts > Email & accounts, remove stale work identities that clash with the signed-in user. In Group Policy or Local Security Policy, turn off legacy restrictions that block Files On-Demand. If icons misbehave, clear the icon cache and reboot.
When A Single File Blocks The Queue
One bad item can stop the line. Use the Activity pane to spot the offender. Then try this flow:
- Rename the file with a short name and basic letters.
- Move it closer to the root so the path gets shorter.
- Close any app that might lock it.
- Upload through the browser to test.
Admin And Work Account Clashes
On managed devices, admin rules can block sync for file types or locations. If you see messages about blocked extensions, you’re hitting a policy. Save the item in a permitted folder or ask for a rule change. Mixed personal and work accounts can also tangle tokens; sign out of one and sign back in to the target account.
Handy Commands And Where They Help
Keep these actions close. They fix the bulk of long-running complaints.
| Action | Platform | When To Use |
|---|---|---|
| Reset with onedrive.exe /reset | Windows | Stuck queue, missing overlays |
| Reset from Terminal | macOS | Sync app won’t relaunch cleanly |
| Repair or reinstall client | Windows & macOS | Corrupt install or repeated crashes |
| Clear credentials | Windows & macOS | Wrong account or token errors |
| Shorten path and rename | Both | Name or length violations |
| Check service health | Both | Wide outage suspected |
Proof You Fixed It
Open the OneDrive menu and watch the count drop. New edits should gain a green check, and the Activity list should turn quiet. In the web view, confirm that a recent change from the device appears within a minute or two.
Care Tips That Prevent New Issues
- Keep folder depth shallow to avoid path limits.
- Use standard letters and numbers in names.
- Close apps before shutting down the device.
- Let large moves finish before putting the lid down.
- Update the client monthly to pick up bug fixes.
When To Check Official Guidance
If symptoms match known bugs or you see a fresh error code, scan Microsoft’s help pages for current notes and outage news. They publish live incident details and monthly client build changes that often reference sync reliability. The notes explain known issues, fixes in current builds, and any workarounds you can apply right away without waiting for the next update.
Last Resort: Start Clean
When all else fails, unlink the PC or Mac, move the local folder aside, and connect the account again. Choose an empty destination folder so the app can hydrate files fresh from the cloud. This keeps data safe in the online copy while giving the client a blank slate.
Quick Reference: Error Clues And Fixes
“You’re Out Of Storage”
Delete big archives, clear the recycle bin online, or upgrade the plan. Free space on the system drive as well.
“Can’t Sync This File”
Shorten the path, remove forbidden characters, and retry. If the item is a temp file from another app, save a new copy with a clean name.
“Credentials Are Out Of Date”
Sign out and back in. Remove stale entries in Credential Manager or Keychain if the prompt repeats.
“Processing Changes” For Hours
Large batches take time. Leave the device awake and plugged in. Close apps that may lock files to let the queue advance.
Helpful links for deeper steps: scan the service health page for live incidents, and keep a bookmark to Microsoft’s OneDrive fix guide for step-by-step cures.
That’s it.