OneDrive Sync Stuck or Stalled? Here's How to Actually Fix It

OneDrive sync failures almost always trace back to one of four things: an expired sign-in session, a full storage quota, a network or proxy block, or a corrupted local sync state. Each has a distinct fix, so the fastest path is checking each cause in order rather than guessing.

1. Check your sign-in status first

An expired session token is one of the single most common causes of a stalled sync queue, and it's easy to miss because OneDrive doesn't always show an obvious error.

1. Click the OneDrive cloud icon in your system tray (Windows) or menu bar (Mac).
2. Look for a banner or warning icon indicating you've been signed out or that your account needs attention.
3. If prompted, re-enter your Microsoft 365 credentials.

2. Check storage space — both cloud and local

OneDrive will silently pause syncing if either your cloud quota is full or your local drive has very little free space remaining (typically under a few hundred megabytes), and it often does this without a loud, obvious warning.

• Open OneDrive settings and check the storage meter under the Account tab.
• Cross-reference against your local drive's free space in File Explorer or Finder.
• If cloud storage is full, either delete files you don't need or look at upgrading your storage plan through your Microsoft 365 subscription.

3. Pause and resume the sync client

This sounds too simple to work, but it resolves a meaningful share of "stuck" syncs by forcing the client to re-evaluate its queue from scratch.

1. Right-click the OneDrive icon in the system tray.
2. Select Pause syncing, choose 2 hours.
3. Wait about 30 seconds, then select Resume syncing.

This often clears transient errors caused by brief network drops or temporary server-side hiccups that the client never properly recovered from on its own.

4. Check for a network or proxy block

If you're on a managed office network, a firewall or proxy may be blocking specific Microsoft 365 endpoints that OneDrive needs to reach, even while general internet access works fine.

• Confirm your firewall or proxy isn't blocking the Microsoft 365 endpoints documented in Microsoft's official URL and IP list.
• If your organization uses a proxy server, check whether the OneDrive executable is whitelisted, or whether the right proxy configuration is being pushed through Group Policy or Intune.
• As a quick test, try syncing from a mobile hotspot instead of the office network — if it suddenly works, the office network's firewall is the culprit.

5. Unlink and relink your account

This is the most disruptive fix, but it resolves stubborn cases that survive everything above.

1. Go to OneDrive Settings, select the Account tab.
2. Click Unlink this PC.
3. Before doing this, confirm any local changes have already uploaded, since unlinking doesn't delete your cloud files but you want to avoid a data discrepancy mid-resync.
4. Sign back in to re-establish a clean sync relationship from scratch.

6. After a password reset specifically

If sync broke right after you reset your Microsoft 365 password, the fix is usually the same unlink-and-relink process above, since the sync client's stored credentials become invalid the moment the password changes. If you can access OneDrive fine through a browser but not through the desktop app, that's a strong sign the desktop client is the only thing holding onto the old credentials.

When to bring in IT

• You suspect the proxy or firewall block, since fixing that usually requires admin-level network configuration changes.
• Multiple people across the team are affected simultaneously — that points to a tenant-wide or network-wide issue, not something specific to your machine.
• You've unlinked and relinked and the same error code keeps appearing — error codes are useful diagnostic information IT can act on directly rather than guessing.