Fix OneDrive Sync Issues

Overview

OneDrive runs quietly in the background, but sync sometimes stalls. A red X, yellow exclamation mark, or "Processing changes" stuck for hours usually means OneDrive needs a nudge. This guide walks you through fixes in order of how disruptive they are, lightest first.

Before You Begin

• You can see the OneDrive cloud icon in the system tray near the clock. If it is missing, open OneDrive from the Start menu.
• Note the exact icon state (red X, yellow triangle, blue cloud, paused). The icon tells you what kind of problem you have.
• Save any open Word, Excel, or PowerPoint files before starting.

Steps

1. Click the OneDrive cloud icon, then the gear icon, then Pause syncing. Wait 10 seconds, then choose Resume syncing. This clears most temporary stalls.
2. If sync is still stuck, click the cloud icon to see which file is the holdup. The status line names the file. Move that file to your desktop temporarily.
3. Restart OneDrive: right-click the cloud icon, choose Quit OneDrive, then open OneDrive from the Start menu again.
4. Reboot your computer. Many sync problems clear after a restart.
5. If sync is still broken, reset OneDrive. Press Windows + R, paste this command, and press Enter:

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

6. Wait two to three minutes. OneDrive restarts automatically. If it does not, open it from the Start menu.
7. Confirm the cloud icon shows blue with a checkmark within 10 minutes. Sync should resume from where it stopped.

Troubleshooting

• If you see "File path too long": rename folders to shorter names. OneDrive supports paths up to 400 characters.
• If you see "Invalid characters": files with \ / : * ? " < > | in the name will not sync. Rename the file.
• If a file conflict appears: OneDrive saves both copies with the second one tagged -YourComputerName. Open both, decide which to keep, and delete the other.
• If you see "Storage full": open OneDrive online, empty the Recycle bin, and remove large unneeded files.
• If reset does not help: uninstall OneDrive from Settings → Apps, reinstall it from https://www.microsoft.com/microsoft-365/onedrive/download, and sign back in.

Related Articles

• Set Up OneDrive on Your Windows PC
• Back Up Your Files With OneDrive
• Restore a Deleted File
• Recover an Earlier Version of a File

Need More Help?

Submit a ticket at support.bostonmit.com or email support@bostonmit.com.