blog

OneDrive Sync Issues: Error Codes Explained (Step by Step)

OneDrive Sync Issues: Error Codes Explained (Step by Step) - OneDrive Sync Issues: Error Codes
OneDrive Sync Issues: Error Codes Explained (Step by Step) - OneDrive Sync Issues: Error Codes

How Do You Fix OneDrive Sync Issues?

To fix OneDrive sync issues, first read the icon or error code, because each one points to a different cause. A red circle means a file cannot sync, a pause icon means sync is paused, and a code like 0x8004de40 means OneDrive cannot reach the cloud. Match your code to the table below, then apply that fix.

Icon or code Commonly reported meaning Fix
Red circle with a white X This file or folder cannot sync Open the OneDrive icon to read the reason; rename, shorten or free space
Pause symbol Sync is paused Click the OneDrive icon and choose Resume syncing
Grey cloud OneDrive is signed out or not running Start OneDrive and sign in
Exclamation mark on the cloud Account issue, often storage Open the OneDrive icon for the account message
0x8004de40 or 0x8004de88 OneDrive cannot connect to the cloud Check internet, then TLS settings; see below
0x8004de90 OneDrive is not fully set up Finish setup or sign in again
0x8004de85 or 0x8004de8a Account mismatch or missing account Sign out and sign in with the right account
0x8007016a The cloud file provider is not running Turn Files On-Demand off and on, update and restart
0x80070194 The cloud file provider exited unexpectedly Restart OneDrive; reset if it repeats
0x80070005 Problem with OneDrive updates or permissions Reset OneDrive and install the latest version
0x8004def7 Storage exceeded or account suspended Check storage and account status

Codes and wording change over time. Check Microsoft’s own error code page if your message differs, and look up any code in our error code index.

This page explains codes. If you see no code and files just do not sync, start with our main checklist, OneDrive not syncing.

What You Need Before You Start

  • Windows 10 or 11, or a Mac, with OneDrive installed.
  • The exact error code. Click the OneDrive cloud icon to see it.
  • Your Microsoft account password.
  • Admin rights on the computer, for TLS or reset steps.

Step 1: Read the Error in the OneDrive Activity Panel

Click the OneDrive cloud icon in the Windows taskbar or Mac menu bar. The panel lists recent activity and any errors at the top. Click an error to see the affected file and the reason.

Write down the code and the file name. If several files fail, look for a pattern, such as the same folder or the same file type.

Step 2: Fix Connection Codes (0x8004de40, 0x8004de88)

Microsoft says these codes mean OneDrive is having trouble connecting to the cloud.

  1. Confirm the computer is online by loading a few websites.
  2. Check Microsoft’s service status for an outage.
  3. Disable any VPN or proxy briefly and try again.
  4. On Windows, press Windows + R, type inetcpl.cpl, open the Advanced tab, and make sure TLS 1.2 is enabled.
  5. Restart the computer and sign in to OneDrive again.

On work or school accounts, your IT team may manage TLS and cipher settings. Share the code with them.

Step 3: Fix Account Codes (0x8004de90, 0x8004de85, 0x8004de8a)

These codes usually mean OneDrive is not linked to the right account.

  1. Click the OneDrive icon, then Settings > Account.
  2. Choose Unlink this PC. Your files stay on the computer.
  3. Sign in again with the account that owns your files, personal or work.
  4. Choose the same OneDrive folder location so files are matched, not downloaded twice.

Still stuck after these steps?

Send us the exact error message or a description of what you see. We use every request to write or update a fix.

Request a fixLook up an error code

Step 4: Fix Files On-Demand Codes (0x8007016a, 0x80070194)

These codes relate to the cloud file provider that makes online-only files work.

  1. Make sure OneDrive is running.
  2. Open OneDrive Settings > Sync and back up > Advanced settings and check Files On-Demand.
  3. Install pending Windows updates and the latest OneDrive version.
  4. Restart the computer.
  5. If the code returns, reset OneDrive, as explained in our OneDrive troubleshooting guide.

Microsoft also notes that outdated antivirus filters can block Files On-Demand. Update your security software.

Step 5: Fix “Can’t Sync” Errors on Single Files

When one file shows a red X, the reason is usually one of these:

  • Blocked name or character. OneDrive rejects " * : < > ? / | and names like desktop.ini.
  • Path too long. The full path must stay within 400 characters.
  • File too large. The limit is 250 GB per file.
  • File in use. Close the program that has it open.
  • Permissions. Right-click the file, choose Properties > Security, and make sure your account has full control.

Step 6: Fix Storage Codes (0x8004def7)

Open your Microsoft storage page and check usage. If you are over the limit, OneDrive becomes read-only until you free space or upgrade. Our guide to OneDrive storage limits walks through clean-up.

How to Verify the Fix

  • The OneDrive icon shows a plain cloud with no warning.
  • The activity panel says files are up to date.
  • A test file appears on onedrive.com within a minute.

Common Mistakes

  • Reinstalling before reading the code. The code often points to a two-minute fix.
  • Signing in with the wrong account. Personal and work accounts look alike.
  • Ignoring single-file errors. One failing file can hold up others.

If OneDrive sits on “processing changes” without a code, see OneDrive stuck syncing. For duplicate files with your PC’s name, see OneDrive sync conflicts.

Frequently Asked Questions

Where do I find my OneDrive error code?

Click the OneDrive cloud icon in the Windows taskbar or the Mac menu bar. Errors appear at the top of the activity panel. Click one to see details, including the code and the affected file. Some codes also appear in a pop-up message when OneDrive starts or tries to sign in.

What does OneDrive error 0x8004de40 mean?

Microsoft says error 0x8004de40, and the related 0x8004de88, mean OneDrive is having trouble connecting to the cloud. Check your internet connection and Microsoft’s service status first. On Windows, make sure TLS 1.2 is enabled in Internet Options, disable VPNs briefly, then restart and sign in again.

Yes. Unlinking disconnects the app from your account but leaves files on your computer and in the cloud. Online-only files remain in the cloud. When you sign in again, choose the same folder location so OneDrive matches existing files instead of downloading duplicates.

Why does OneDrive say a file can’t be synced?

The usual reasons are a blocked character in the name, a path over 400 characters, a file over 250 GB, a file open in another program, or missing permissions. Click the error in the OneDrive activity panel to see the exact reason, then rename, move or close the file accordingly.

Do OneDrive error codes differ on Mac and Windows?

Most codes are shared, but some steps differ. On Mac, sign-in problems are often fixed by removing cached OneDrive credentials in Keychain Access and restarting the app. Files On-Demand codes are Windows-specific. Always install the latest OneDrive version on either platform before deeper troubleshooting.

Keep your files safe and in sync

Join the newsletter for the free troubleshooting checklist and outage alerts. Facing a specific error? Tell us about it and we will point you to the right fix.

Get the free checklistRequest a fix

About the author: Michael Johnny

Michael Johnny is a cloud sync and backup specialist with 10 years of hands-on experience setting up and troubleshooting OneDrive, Google Drive, Dropbox, iCloud, NAS and self-hosted sync tools. He writes every syncfix.cloud guide from the settings screens themselves and rechecks menu paths and limits when providers change them. More about syncfix.cloud.

Last updated: October 16, 2026. Menu names and limits can change after an app update; if something looks different, let us know.

Sources

  1. What do the OneDrive error codes mean? (Microsoft Support)
  2. Error 0x8004de40 or 0x8004de88 when signing in to OneDrive (Microsoft Learn)
  3. Restrictions and limitations in OneDrive and SharePoint (Microsoft Support)
  4. Fix OneDrive sync problems (Microsoft Support)
OneDrive Sync Issues: Error Codes Explained (Step by Step) - OneDrive Sync Issues: Error Codes

هل أصلح هذا المشكلة؟

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

تم التصميم والسيو بواسطة قروش السيوواتساب +20 112 057 7167أعلن معنا