Home / Guides / Apps & Programs

OneDrive Won't Sync

Beginner Apps & Programs Applies to: Windows 10, Windows 11

The cloud icon shows a warning, a spinning "processing changes" that never finishes, or files that simply never make it to another device.

Before you start: save any open work and note down what you were doing when the problem started — that context helps if you need to search further or ask for help.
  1. Click the OneDrive cloud icon in the taskbar to check its current status — a warning triangle or red X tells you it already knows something's wrong, and clicking through often shows the specific reason.
  2. Check you're actually online and signed into the correct Microsoft account — click the OneDrive icon > Help & Settings > Settings to confirm the account shown is the one you expect.
  3. Run Microsoft's official reset command, which restarts OneDrive's sync engine without touching your files: press Windows+R, paste %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. OneDrive should reopen on its own after a minute; if it doesn't, launch it manually from the Start menu.
  4. Check you haven't hit your storage quota — OneDrive stops syncing new files once you're full, and the free tier's limit is easy to hit without realizing it.
  5. Check for restricted characters or overly long file paths — OneDrive won't sync file or folder names using characters like * : < > ? / \ | or " , and it has a roughly 400-character total path limit; a deeply nested folder structure can quietly exceed this.
  6. Check whether your connection is set as metered (Settings > Network & internet > your connection > Metered connection) — OneDrive automatically pauses syncing over metered connections by default to avoid data charges.
  7. If you're on a laptop, check whether Battery Saver is active — OneDrive can pause syncing while it's on, which is easy to miss since it happens silently in the background.
  8. As a last resort, unlink and relink your account (OneDrive icon > Help & Settings > Settings > Account > Unlink this PC, then sign back in) — this doesn't delete anything, your files stay in the cloud and simply resync afterward.
Still not fixed? Send us the details and we'll help you dig further, or browse related guides in Apps & Programs.

Frequently Asked Questions

Will resetting OneDrive delete any of my files?
No — the reset command restarts OneDrive's sync engine only. Your files remain safely in the cloud and on your PC; it simply re-establishes the connection between them.
How do I know if I've hit my storage limit?
Click the OneDrive icon in the taskbar and check Settings — it shows how much of your storage plan is used. The free tier's limit is easy to hit without realizing it, especially with photos or videos syncing automatically.

Related guides

An App Won't Open

You click the icon and nothing happens, or it flashes and closes immediately.

Beginner

An App Won't Uninstall

The uninstaller fails, hangs, or the app reappears after removal.

Intermediate

An App Keeps Crashing

It opens fine but closes unexpectedly, sometimes with an error, sometimes without.

Beginner