OneDrive · Fix-itDraft

OneDrive isn't syncing (red X or stuck)

Draft. Not published yet.

The OneDrive cloud in the notification area shows a red X, sits on “Processing changes,” or never catches up. Your files are usually still on the PC and in the cloud. The sync connection between them is what’s stuck.

Don’t delete files to “force” a refresh. Microsoft’s reset and unlink steps keep your files. The goal is to find out why sync stopped, fix that, and only then reset if needed.

These steps are for the OneDrive sync app on Windows, for a personal account or a work or school account.

Before you start

  1. Select the OneDrive cloud icon in the notification area (the ^ arrow on the taskbar may be hiding it). Read the exact status: paused, not signed in, storage full, or a file error. Microsoft’s sync problems page branches on that icon.
  2. If you don’t see any OneDrive icon, open Start, type OneDrive, and open the OneDrive desktop app.
  3. Confirm you can sign in at https://onedrive.live.com (personal) or https://portal.office.com (work or school). If the web sign-in fails, fix that first.
  4. Note any file OneDrive names in the Activity or error list. You’ll use that in the filename and path checks below.

1. Check the simple blockers

Work through these first. Stop if the icon returns to “Up to date.”

  1. If OneDrive is paused, open the OneDrive window and resume sync. A pause is easy to miss after a meeting or a low-battery setting.
  2. If you’re not signed in, sign in with the same account you use on the web.
  3. If storage is full or nearly full, you won’t be able to upload or sync new files until you free space in OneDrive or change your storage plan. You can still download existing files in many cases. Check storage on the OneDrive website.
  4. If a file is open in Word, Excel, or another app, save and close it. OneDrive can’t sync a file that’s locked by another program, including an Outlook data file stored in your OneDrive folder.
  5. Make sure the PC is online and that you’re not on a metered connection that’s set to defer OneDrive.

2. Fix file names, invalid characters, and long paths

OneDrive won’t sync some names or very long folder paths.

Rename files or folders that contain these characters, which Microsoft documents as not allowed:

" * : < > ? / \ |

Also avoid leading or trailing spaces, and reserved names such as CON, PRN, AUX, NUL, desktop.ini, names like COM0–COM9 or LPT0–LPT9, anything with _vti_ in the name, or a name that starts with ~$.

If the path is very long (deep folders plus a long file name), shorten folder names or move the file closer to the top of your OneDrive. Official limits to know:

  • OneDrive and SharePoint in the cloud: the decoded path, including the file name, can’t exceed 400 characters.
  • The OneDrive sync app: the total path can go up to 520 characters. Longer paths show a sync error.
  • Windows File Explorer and Office desktop apps still commonly hit a 260-character limit, so a file can exist on the web and still fail to open or rename on the PC.

If File Explorer won’t let you rename the item, rename it on the OneDrive website, then wait for sync.

Microsoft documents unlink and re-link as a safe way to refresh the connection. Files are not deleted. The local folder is disconnected from the cloud for a short time, then changes sync when you sign back in.

  1. Select the OneDrive cloud icon, then the Help & Settings gear, then Settings.
  2. Open the Account tab, choose Unlink this PC, and confirm.
  3. Press Windows + R, paste %localappdata%\Microsoft\OneDrive\settings, and press Enter.
  4. Delete the file named PreSignInSettingsConfig.json if it’s there. That’s the credential-clear step Microsoft includes with an unlink.
  5. Open OneDrive from the Start menu and sign in.
  6. When OneDrive says a folder already exists, choose Use this folder if that’s your current OneDrive location, unless you intentionally want to move it.
  7. Wait for it to catch up. OneDrive won’t necessarily download every file. With Files On-Demand, you often get placeholders first.

If you had chosen to sync only some folders, you’ll need to pick those folders again after you sign in.

4. Reset OneDrive

Reset if unlink didn’t fix it. Microsoft says a reset does not delete your files. It disconnects sync connections (personal and work or school) and OneDrive does a full sync afterward.

  1. Press Windows + R, type wsreset.exe, and press Enter. A Command Prompt window may flash and Microsoft Store may open. You can close those windows.

  2. Press Windows + R again, paste this, and press Enter:

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

  3. If you get “Windows cannot find…,” try this instead:

    C:\Program Files\Microsoft OneDrive\onedrive.exe /reset

  4. If that also fails, try:

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

  5. If OneDrive doesn’t reopen on its own, open Start, type OneDrive, and launch the OneDrive desktop app.

If none of those paths work, the sync app may not be installed. Install it from Microsoft and sign in.

After a reset, reselect any folder list you had narrowed down, for each OneDrive account on the PC.

What not to do

  • Don’t delete your OneDrive folder to “start over.” That’s how files get lost if they hadn’t finished uploading.
  • Don’t move thousands of files out of OneDrive and back in as a first step. Use that only for a single problem file Microsoft says to temporarily move out, then copy back after OneDrive is “Up to date.”
  • Don’t ignore a storage-full message and keep resetting. Reset won’t add storage.

Still stuck?

If OneDrive is still stuck after an unlink and a reset, I can look at the error with you over a remote session. Support is after-hours, nationwide, with local help in the Dallas–Fort Worth area. See the Work with me page.

Sources checked