Fixity Labs

OneDrive not syncing on Windows: a step-by-step checklist

Work through the usual reasons OneDrive stops syncing, in order: sign-in, paused sync, storage, problem files, app version and finally a reset.

Updated
Reading time
3 min
Applies to
OneDrive for Windows, OneDrive for work or school

The problem

“OneDrive is not syncing” covers very different problems: the app is not running, you are signed out, storage is full, one file is blocking a folder, or the app itself needs a reset. Start with the status icon. It tells you which of these you are dealing with.

What the OneDrive status icon tells you

IconMeaningStart with
Red circle with a white XA file or folder cannot syncOpen the activity center and read the error for that item
Circular arrowsSync is in progress or changes are pendingWait, or see the guide on “Sync pending”
Pause symbolSyncing is pausedResume syncing from the OneDrive menu
Grey cloud or no iconOneDrive is not running or not signed inStart OneDrive and sign in

Icons can differ slightly between versions of the OneDrive app.

Symptoms

  • Files saved on this PC do not appear on OneDrive.com or on other devices.
  • Changes made on another device do not arrive on this PC.
  • The OneDrive icon shows an error, a pause symbol or nothing at all.

Causes

  • Not running or signed out

    OneDrive closed, or the account sign-in expired after a password change.

  • Sync paused

    Sync was paused manually or automatically, for example by battery saver or a metered network.

  • Storage full

    When your OneDrive storage is full, new and changed files stop uploading.

  • Problem files

    Invalid names, paths that are too long or files over 250 GB stay behind with an error.

  • Very large libraries

    Microsoft recommends syncing no more than 300,000 items in total. Above that, sync can slow down considerably.

  • Outdated or stuck app

    An old OneDrive version or a damaged local sync state can stop sync entirely.

How to fix it

  1. Check that OneDrive is running and signed in

    Look for the OneDrive cloud in the notification area. If it is missing, open OneDrive from the Start menu and sign in with the account that owns the files.

  2. Resume syncing

    Select the OneDrive icon, open Settings and choose Resume syncing if sync is paused.

  3. Check your storage

    Open the OneDrive settings and look at the storage used. Free up space or add storage if it is full.

  4. Read the errors in the activity center

    Select the OneDrive icon. Items that cannot sync are listed with a reason. Invalid names and long paths are fixed by renaming or moving the item.

  5. Restart OneDrive

    Select the OneDrive icon, open Settings, choose Quit OneDrive, then start it again from the Start menu.

  6. Update Windows and OneDrive

    Install pending Windows updates and make sure you have the current version of the OneDrive app.

  7. Reset OneDrive

    If nothing else helps, reset the app. Press Windows key + R and run the first command. If Windows cannot find it, try the second, then the third. A “Windows cannot find” message for all three means the OneDrive sync app is not installed.

    %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
    C:\Program Files\Microsoft OneDrive\onedrive.exe /reset
    C:\Program Files (x86)\Microsoft OneDrive\onedrive.exe /reset

Before you change anything

  • Resetting OneDrive does not delete your files, but it disconnects all sync connections, including work or school accounts and synced SharePoint libraries. You may need to set them up again, and the first sync afterwards can take a long time.
  • Do not delete files from the OneDrive folder to “start over”. Deleting synced files deletes them in the cloud too.

When OneDriveSyncFixer helps

Microsoft documentation

This guide summarizes Microsoft’s published guidance in our own words. Microsoft documentation remains the authoritative source.

Related guides

  • OneDrive stuck on “Sync pending” or “Processing changes”

    What “Sync pending” and “Processing changes” mean, why they can last for hours, and how to find the hidden, temporary or open file that is holding sync back.

    Sync troubleshooting3 min read

  • OneDrive error codes explained

    What common OneDrive error codes such as 0x8004de40, 0x8004def7 and 0x8007016A indicate according to Microsoft, and where to start fixing each one.

    Error codes2 min read

  • How to fix invalid file names in OneDrive

    OneDrive and SharePoint skip any file or folder whose name breaks their naming rules. Learn the rules, find the affected items and rename them without breaking links.

    File names and paths3 min read

  • SharePoint library won’t sync: causes and fixes

    Troubleshoot SharePoint libraries that will not sync with the OneDrive app: a missing Sync button, read-only libraries, credentials, conflicts and the naming and size rules.

    Sync troubleshooting3 min read