OneDrive sync stuck? 6 fixes that actually work

OneDrive sync usually just works. When it doesn't, you can spend hours staring at the spinning blue icon. These six fixes — in order from least to most disruptive — cover almost every real sync problem.

Do them in order. Stop as soon as sync resumes.

1. Check what OneDrive says

Click the OneDrive cloud icon in the system tray (next to the clock). The activity center opens.

Look for:

• A red circle with X — something is broken.
• An info banner at the top — usually tells you exactly what's wrong ("You're out of storage," "File path too long," "Sign in again").
• A specific file marked as failing — right-click → Resume sync.

90% of "stuck OneDrive" cases are a specific file failing for a clear reason. Read the message first.

2. Pause and resume sync

If there's no obvious error:

1. OneDrive icon → gear → Pause syncing → 2 hours.
2. Wait 30 seconds.
3. Click Resume syncing.

This forces OneDrive to re-handshake with the server. Fixes weirdly often.

3. Restart the OneDrive client

1. OneDrive icon → gear → Quit OneDrive.
2. Press Windows key, type OneDrive, hit Enter.
3. Wait for it to re-sign in and rebuild the index.

The rebuild can take a few minutes on big folders.

4. Check file-name and path issues

OneDrive can't sync:

• File paths longer than 400 characters (full path including filename).
• File names with these characters: " * : < > ? / \ |
• Files with trailing spaces or dots in the name.
• File names like CON, PRN, AUX, NUL, COM1–9, LPT1–9 (Windows reserved).
• Files larger than 250 GB (Microsoft 365 personal/business limit).

Right-click → Rename to fix any culprits, then sync will move on.

5. Unlink and relink the account

If OneDrive is still stuck after the above:

1. OneDrive icon → gear → Settings → Account → Unlink this PC.
2. Close all Office apps.
3. Open OneDrive again, sign back in.
4. When asked, use the same OneDrive folder location — don't move it.

OneDrive treats this as a fresh sync but recognizes the existing files. The first hour, your hard drive may be busy as it re-validates every file.

6. Reset OneDrive (nuclear)

Last resort — fixes corrupted local databases:

1. Press Windows + R.
2. Paste this exactly:

   %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
   

3. Press Enter. Nothing visible happens (this is normal).
4. After 2 minutes, press Windows + R again and run:

   %localappdata%\Microsoft\OneDrive\onedrive.exe
   

5. Sign back in.

A reset doesn't delete your files — it rebuilds the sync database. Your local copies stay on disk, your cloud copies stay in OneDrive, and the two are re-matched.

Specific error codes

• 0x8004de40 — sign-in / authentication issue. Restart OneDrive, sign out, sign back in.
• 0x8004de85 — Microsoft account conflict. Make sure you're signing into the right account (personal vs work).
• Error 0x8004def7 — your OneDrive is over quota. Clear space (see our free-up-space guide).
• "OneDrive can't connect to Windows" — usually fixed by Settings → Apps → OneDrive → Advanced options → Reset.

When the cloud is right and your PC is wrong

If a teammate insists they changed a file but you still see the old version:

1. Check OneDrive web first — look at the file in the browser to confirm the new version exists in the cloud.
2. On your PC, right-click the file → OneDrive → Version history. Sometimes the file has both versions saved; pick the right one.
3. Worst case: delete the local file, let OneDrive re-download the cloud version.

TL;DR

Read the OneDrive client's banner first — it usually tells you the answer. Then: pause/resume, restart, fix path issues, unlink/relink, and only as a last resort run onedrive.exe /reset. Resets don't delete your files.