/
OneDrive - Resolve Sync Issues

OneDrive - Resolve Sync Issues

Problem

This guide helps resolve common sync issues in OneDrive.

Solution

1. Check the OneDrive icon

Look for the OneDrive cloud icon near the clock on the taskbar.

What the icon usually means:

  • Red circle with white X = A file or folder is not syncing

  • Paused icon = Sync is paused

  • Circular arrows = Sync is in progress

  • Green check = The file is on your computer, but that does not always mean the newest version is already uploaded

  • Blocked-file icon = A file type is blocked from syncing

  • No OneDrive icon = OneDrive may be hidden, closed, signed out, or not running

2. Try these 5 quick fixes

Do these in order:

  1. Resume syncing if OneDrive is paused

  2. Close the file and close any Office apps using it

  3. Pause OneDrive, then resume it

  4. Quit OneDrive and open it again

  5. Make sure OneDrive is updated

3. Check whether the newest file is online

Open OneDrive on the web or the related SharePoint or Teams folder and look for the newest version of the file.

  • If the newest version is online but not on your computer, the problem is usually with OneDrive on the PC.

  • If the newest version is missing online too, the problem may be saving, upload, permissions, storage, or the shared library itself.

4. If OneDrive says “Processing changes”

This usually means OneDrive is still working. Common reasons include:

  • The file is still open

  • The file is large

  • Many files were recently added, moved, or renamed

  • Your connection is slow

What to do:

  • Wait a little longer if you recently moved or changed many files.

  • If nothing changes after 10 to 15 minutes, go to the next section.

5. If OneDrive says “Sync pending”

What to do:

  1. Restart OneDrive

  2. Check whether the file is open in Word, Excel, PowerPoint, or another Office app

  3. Try syncing again

If it still says Sync pending, stop here and contact IT. Your original guide notes that the next fix may involve clearing the Office Document Cache, which is not a good self-service step for most employees.

6. Check for file or folder problems

A file may not sync if there is a problem with its name, type, location, or available storage.

Check for these common issues:

  • The file name contains special characters that are not allowed

  • The file or folder name starts or ends with a space

  • The file type is blocked

  • The file path is too long

  • There is not enough storage space

  • Too many files are syncing at once

  • The name uses a reserved word such as CON, PRN, AUX, NUL, or starts with ~$

What to do:

  • Shorten the file name

  • Move the file to a folder closer to the top of OneDrive

  • Remove unusual symbols from the name

  • Free up storage space if OneDrive is full

7. Reconnect OneDrive

If the problem still is not fixed:

  1. Open OneDrive Settings

  2. Open the Account tab

  3. Select Unlink this PC

  4. Sign in again and reconnect your account

Contact IT if:

Submit a ticket if any of these are true:

  • You still see Sync pending after restarting OneDrive

  • You are unsure whether a file type is blocked

  • You think the issue is with permissions, storage, or the shared library

  • Reconnecting OneDrive did not fix the issue

  • You are asked to run commands or reset OneDrive manually (see below)

 

(Advanced) Reset OneDrive if reconnecting does not help

If you are comfortable, you may do the following. Otherwise submit a ticket to IT.

A reset does not delete files, but it disconnects sync relationships and triggers a full sync again afterward.

Before you reset: Users who previously selected only certain folders may need to choose those folders again after the reset finishes.

Method A – Run dialog

  1. Press Windows key + R.

  2. Enter:

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

  3. If Windows cannot find it, try:

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

  4. If that also fails, try:

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

  5. After the reset command runs, open OneDrive again from the Start menu.

Method B – Command Prompt

Open Command Prompt and run the same reset commands. Use quotation marks for paths that contain spaces.

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