How to Fix OneDrive Sync Errors and Stuck Files on Windows

Published 2026-10-16 · Marion Remote Fix

OneDrive shows a red X or warning icon on files that are not syncing. The sync status is stuck on Processing Changes for hours. Files you save on one device do not appear on another. Or OneDrive displays an error message about being unable to sync specific files. OneDrive sync errors are frustrating because they undermine the primary purpose of cloud sync — having your files available everywhere. Most sync errors have specific causes and straightforward fixes.

Check OneDrive status

  • Click the OneDrive icon in the system tray (the cloud icon near the clock). The status panel shows whether OneDrive is syncing, paused, up to date, or experiencing errors
  • If the icon shows a pause symbol, OneDrive sync is paused. Click the icon and select Resume Syncing. OneDrive can pause itself on metered connections, low battery, or when the system is under heavy load
  • If the icon is grayed out, OneDrive is not signed in or not running. Click it to open OneDrive and sign in with your Microsoft account
  • If the icon shows a red circle with a white X, there are sync errors that need attention. Click the icon and then click the error or warning message to see details about which files are affected

Common sync error causes

File name or path issues

  • OneDrive cannot sync files with names that contain certain characters. Characters not allowed include backslash, forward slash, colon, asterisk, question mark, quotation marks, angle brackets, and pipe. Rename the file to remove these characters
  • The full file path (folder location plus file name) cannot exceed 400 characters. Deeply nested folders with long names create paths that exceed this limit. Shorten folder names or move the file closer to the OneDrive root folder
  • Some file names are reserved by Windows and cannot be synced: CON, PRN, AUX, NUL, COM1 through COM9, and LPT1 through LPT9. Rename files with these names
  • File names with leading or trailing spaces, or names that end with a period, can cause sync errors on some systems. Clean up the file names to remove these edge cases

File size limits

  • OneDrive has a maximum file size for sync. The current limit is 250 GB per file. Files larger than this limit will not sync and show an error
  • For most users, the storage quota is the limiting factor rather than file size. A free OneDrive account has 5 GB of storage. A Microsoft 365 subscription provides 1 TB. If your OneDrive is full, new files cannot sync until you free space or upgrade your plan
  • Check your storage usage by clicking the OneDrive icon, then Settings, then Account (or Storage). This shows how much of your quota is used

File in use

  • OneDrive cannot sync a file that is currently open and locked by an application. Large files like Outlook PST databases, database files, and virtual machine disk images are often locked by the application using them and will not sync while in use
  • Close the application using the file, let OneDrive sync it, then reopen the application. If the file must remain open continuously, it may not be suitable for OneDrive sync
  • Some applications lock files even when they appear closed. Check Task Manager for background processes related to the application that may still be holding the file open

Reset OneDrive sync

  • If OneDrive is stuck on Processing Changes or shows persistent sync errors that do not resolve on their own, resetting OneDrive clears the local sync database and forces a fresh comparison between your local files and the cloud
  • Open the Run dialog (Windows+R) and enter the OneDrive reset command. OneDrive closes and restarts automatically after a minute or two. When it restarts, it rechecks all files and resyncs anything that was stuck
  • The reset does not delete any files from your computer or from the cloud. It only resets the sync engine internal state. Your files remain intact on both sides
  • After the reset, OneDrive may take some time to re-process all files, especially if you have a large number of files. The OneDrive icon may show syncing activity for a while as it rechecks everything

Unlink and relink the account

  • If resetting does not fix the problem, unlinking your Microsoft account from OneDrive and relinking it performs a more thorough reset
  • Click the OneDrive icon, select Settings, then Account, then Unlink This PC. This disconnects OneDrive from the local folder but does not delete your files from either location
  • After unlinking, reopen OneDrive and sign in again. OneDrive will ask you to choose a folder location and which folders to sync. Select the same location and folders as before. OneDrive merges the local files with the cloud files, syncing any differences

Selective sync and Files On-Demand

  • OneDrive Files On-Demand lets you see all your cloud files in File Explorer without downloading them all. Files with a cloud icon are online-only and download when you open them. Files with a green checkmark are available locally
  • Sync errors with on-demand files can occur if the file is needed but the internet connection is not available. If you need files available offline, right-click them and select Always Keep on This Device
  • If Files On-Demand is causing problems (files not opening, slow access, unexpected downloads), you can disable it in OneDrive Settings, Sync and Backup, Advanced Settings. Disabling it downloads all cloud files locally, which requires enough local disk space

Conflicting copies

  • When the same file is edited on two devices before either change syncs, OneDrive cannot merge the changes automatically. It creates a conflict copy — a second file with the device name and date appended to the file name
  • To resolve conflicts, open both versions, compare them, and merge the changes manually into one file. Then delete the conflict copy. For Office documents, OneDrive may offer to show you the differences between the two versions
  • Conflicts happen most often when editing files offline on multiple devices. To minimize conflicts, ensure OneDrive has finished syncing before editing the same file on a different device

Internet and firewall issues

  • OneDrive requires a stable internet connection to sync. If your connection is slow, intermittent, or has high packet loss, sync operations may time out and report errors
  • Firewalls and proxy servers can block OneDrive traffic. If you are on a corporate network and OneDrive does not sync, the network may be filtering OneDrive connections. Check with the network administrator
  • Some antivirus programs and security suites inspect encrypted traffic in ways that interfere with OneDrive sync. If sync errors started after installing or updating security software, try temporarily disabling the web protection component to test

Windows permission issues

  • If OneDrive cannot access a file due to Windows file permissions, it reports a sync error for that file. This can happen when files are created by a different user account, restored from a backup with different ownership, or have restrictive permission settings
  • Right-click the problem file, select Properties, go to the Security tab, and verify that your user account has Full Control. If not, click Edit and add the necessary permissions
  • Running a permission reset on the entire OneDrive folder can fix widespread permission issues. Taking ownership of the OneDrive folder and all its contents resets permissions to your user account

Need help with OneDrive sync?

If OneDrive is not syncing properly and the steps above have not resolved the errors, Marion Remote Fix can remotely diagnose sync problems, reset the OneDrive client, fix file permission issues, and configure OneDrive settings for reliable synchronization across your devices.

← Back to Blog