OneDrive holds more than 250 million active users, and nearly every one of them has stared at a stuck sync icon at some point. The green checkmark freezes, the blue arrows spin forever, and a file you edited an hour ago still hasn’t reached your other devices. The good news: most sync failures trace back to a short list of causes, and nearly all of them are fixable without calling support.
This guide walks through the fixes in the order a technician would try them, from the two-second checks to the deeper resets. It also flags the mistakes people make most often, because knowing what not to do saves more time than knowing what to do.
Start With the Two Checks Everyone Skips
Before touching settings, confirm two basics. First, look at the cloud icon in the system tray (Windows) or menu bar (macOS). If it shows a paused symbol or a red slash, sync is simply turned off. Click it and choose Resume syncing. Second, open the OneDrive folder in File Explorer or Finder and look for a file with “Sign in required” or a red X overlay. An expired password or a changed Microsoft account password breaks the connection silently, and re-entering credentials fixes it in seconds.
A surprising share of “OneDrive not syncing” complaints end right here. The most common fix is the least dramatic one.
Check Whether the Problem Is You or Microsoft
If your account looks healthy, find out whether the service itself is having a bad day. Microsoft publishes live status for its cloud services, and a regional outage will stall sync for thousands of users at once. No amount of local troubleshooting helps during an outage; you just wait.
The tell is scope. If one file won’t sync, the problem is local. If nothing syncs on every device, check the service status first. That single step prevents an hour of pointless resetting.
Confirm You Actually Have Storage Space
A full OneDrive quota stops uploads without much fanfare. The icon may show a warning rather than a clear error. Open OneDrive settings, go to the Account tab, and read the storage bar. If you’re at or near 100 percent, new files queue up and never move. (OneDrive)
Free accounts get 5 GB, and Microsoft 365 subscribers get 1 TB or more depending on plan. If you’re full, delete large files, empty the recycle bin (deleted cloud files still count until purged), or upgrade. This is one of the top causes people miss because the symptom looks identical to a network fault.
Deal With Files On-Demand Confusion
Files On-Demand keeps files in the cloud and downloads them only when opened. It saves disk space, but it creates a specific kind of confusion: files appear in your folder, yet they aren’t really on your machine. If you’re offline or the feature is misbehaving, those files won’t open, and it looks like sync has failed.
The fix is to check the status icons next to files. A cloud outline means online-only; a green check means downloaded; a filled green circle means always keep on this device. Right-click a stubborn folder and choose Always keep on this device to force a download. If the feature itself seems broken, toggle it off in settings, restart the app, and turn it back on.
Restart the Sync Engine Properly
Closing the window doesn’t stop OneDrive; it keeps running in the background. A real restart means quitting it from the tray icon and reopening it from the Start menu or Applications folder. That alone clears a lot of transient glitches.
If a restart doesn’t help, the reset command is the next rung. On Windows, open Run (Win+R) and enter the OneDrive reset path, which lives under your local app data folder and ends with the reset switch. The app closes, reopens, and rebuilds its sync database. Files aren’t deleted, but a full re-scan can take a while on large libraries. On macOS, quit OneDrive, move the app to the trash, reinstall it from the official source, and sign in again. Patience matters here: a reset on a 500 GB library can churn for hours. (OneDrive help and learning)
Reset vs. Reinstall: Which One?
| Situation | Best Action | What Happens |
|---|---|---|
| Sync stuck, files fine | Reset command | Rebuilds sync database, keeps settings |
| App won’t launch at all | Reinstall | Fresh install, sign-in required |
| Repeated crashes | Reinstall | Clears corrupted program files |
| One stubborn folder | Unlink and relink folder | Re-syncs just that folder |
Unlink and Relink a Problem Folder
Sometimes the account is fine but one folder has gone rogue. In OneDrive settings, find the Account tab and choose Unlink this PC (or the Mac equivalent). Then sign in again and point OneDrive at the same folder. It re-scans and re-uploads anything missing.
Watch for one trap: if you pick a different folder path during setup, you’ll end up with two copies and a mess to clean up. Use the exact original location.
Rule Out Network, VPN, and Security Software
OneDrive needs outbound access on standard HTTPS ports. Corporate firewalls, aggressive VPNs, and some security suites block or throttle that traffic. If sync works on your phone’s hotspot but not on office Wi-Fi, the network is the culprit.
Test by disconnecting the VPN and pausing third-party antivirus temporarily, then editing a file and watching for the sync arrow. If it moves, whitelist OneDrive in the firewall and antivirus. This category overlaps with general connectivity problems; if pages won’t load either, work through a guide on how to fix a website that will not load before blaming OneDrive. And if your antivirus is eating CPU while you troubleshoot, the steps to fix antimalware service executable high CPU usage are worth a look, since a pegged system can make sync appear frozen.
Check File and Folder Names
OneDrive rejects certain characters and name patterns. Names containing characters like ` : ” / | ? *` fail to upload, and so do files over 250 GB. Paths longer than 400 characters can also break. The sync log will name the offender, but the faster route is to scan recent additions for odd punctuation.
This trips up people syncing projects from other systems. A file that opens fine locally may be silently blocked from the cloud, and the only clue is a red X badge.
Look at the Sync Log When Nothing Else Works
OneDrive keeps a log of sync activity, and it’s the closest thing to a black box recorder. On Windows, the log sits in the OneDrive settings under a “view sync problems” or activity area, listing every failed file with an error code. Read it before resetting anything, because it usually names the exact cause: a locked file, a permission issue, a name conflict.
On Mac, the activity window shows similar detail. Error codes like 0x8004de40 typically mean connectivity, while access-denied codes point to permissions on shared folders.
Handle Conflict Copies and Shared Folder Permissions
Files named with “-Copy” or your computer name appended are conflict copies. They appear when two devices edit the same file before sync catches up. They aren’t a sync failure, but they signal one: the timing is off. Close files when you finish editing, and let sync complete before switching devices.
Shared folders add another layer. If someone shares a folder with you as view-only, your edits won’t upload, and OneDrive may not explain why clearly. Check the permission level on shared items in the web version.
Update Windows, macOS, and the App Itself
Old app versions and outdated operating systems cause sync failures that look mysterious. OneDrive updates itself, but a stalled updater leaves you on an old build. Reinstalling pulls the current version. Likewise, an out-of-date OS can break the authentication handshake.
If you’ve recently moved your system to a new drive, sync problems can follow a botched migration; the same care that goes into a clone hard drive to SSD job applies here, since a half-migrated user profile confuses OneDrive about where its folders live.
When Should You Contact Support?
Escalate when the sync log shows persistent server-side errors, when multiple accounts fail on the same machine, or when a reset and reinstall both fail. Microsoft support can inspect backend logs you can’t see. Before contacting them, gather the error codes from the sync log and note the exact time the problem started; that information shortens the process considerably.
Mistakes That Make Things Worse
A few habits turn a small sync glitch into a data problem. Don’t delete the local folder to “force a re-sync” unless you’ve confirmed everything is in the cloud, because deletion propagates. Don’t run the reset command repeatedly in quick succession; each run restarts the scan and can leave the database half-built. Don’t ignore the quota warning and assume it will sort itself out. And don’t rename folders mid-sync, which generates conflict copies across every device.
The pattern behind most of these: impatience during a re-scan. Give the engine time to finish before judging whether a fix worked.
A Quick Diagnostic Order That Works
When a reader asks where to start, the practical sequence is short. Check the icon for pause or sign-in prompts. Check service status. Check storage. Restart the app. Reset it. Reinstall. Then dig into logs. That order moves from the most common cause to the least, and it avoids the trap of resetting a healthy install because of a full quota.
The same logic applies to other software quirks. If a companion tool misbehaves, the pattern of checking status, restarting, and reading logs carries over; the Decky loader not working Steam Deck fix 2026 guide follows a similar escalation. And for anyone producing video content, tools like the best AI lip sync tools for videos have their own sync quirks worth understanding, though they’re unrelated to cloud storage.
Conclusion
OneDrive sync failures feel opaque because the app hides its reasoning behind a small icon. In practice, the causes are narrow: a paused sync, an expired sign-in, a full quota, a network block, a bad file name, or a corrupted local database. Work through them in order, read the sync log before resetting, and resist the urge to delete folders to force a refresh. Most people fix the problem in under ten minutes once they know which rung of the ladder they’re on. When the local fixes run out, the service status page and Microsoft support close the gap.
Frequently Asked Questions
Why is OneDrive stuck on “processing changes” forever?
This usually means a large file or a huge batch of changes is queued, or the sync database is corrupted. Give it an hour on a big library, then run the reset command. If it still hangs, check the sync log for a specific file that’s failing.
Does resetting OneDrive delete my files?
No. The reset rebuilds the local sync database and re-scans your library. Your files stay in the cloud and on disk. However, any file that only existed locally and never uploaded should be backed up first, just in case.
Why does OneDrive say “sign in required” when I’m already signed in?
The authentication token expired, often after a password change or a long period offline. Click the prompt and re-enter your credentials. If it repeats, clear cached credentials in Windows settings and sign in fresh.
Can a VPN stop OneDrive from syncing?
Yes. Some VPNs and corporate firewalls block or throttle the outbound connections OneDrive needs. Disconnect the VPN and test an edit. If sync resumes, whitelist OneDrive in the VPN or firewall configuration.
Why do I have files ending in “-Copy”?
Those are conflict copies created when two devices edited the same file before sync caught up. They aren’t errors, but they signal timing problems. Close files after editing and let sync finish before switching devices.
How much storage do I need for OneDrive to work?
Free accounts include 5 GB, and Microsoft 365 plans start at 1 TB. Sync stops when the quota fills, including files sitting in the cloud recycle bin. Empty the bin and check the storage bar in account settings if uploads stall.
