Skip to main content
OneDrive sync problems range from a single file that refuses to upload to an entire sync client that becomes completely unresponsive. The OneDrive client communicates constantly with Microsoft’s cloud storage service, and interruptions — whether from file locks, path length violations, corrupted local caches, or authentication token expiry — can cause the sync process to stall or report errors. This guide takes you through diagnosing and fixing the most common OneDrive sync issues from start to finish.

​
Identifying the Problem

Before applying a fix, understand what OneDrive is telling you.
1

Check the OneDrive tray icon

Look for the OneDrive cloud icon in the system tray (Windows) or menu bar (macOS):
  • White cloud, animated arrows: Actively syncing
  • White cloud, no animation: Sync is up to date
  • Blue cloud: Personal OneDrive sync in progress
  • Red circle with X: Sync error — click to see details
  • Yellow triangle with !: Warning — something needs attention but sync is still running
  • Grey cloud: OneDrive is not running or signed out
2

View sync errors

Click the OneDrive icon, then click View sync problems or the error notification to open the activity panel. This lists every file or folder with a sync issue and the associated error code.
3

Check Windows Event Viewer (advanced)

For deeper diagnostic information, open Event Viewer → Applications and Services Logs → Microsoft → OneDrive. Error events here often contain internal error codes and file paths not shown in the OneDrive UI.

​
Common Error Codes

This error means the OneDrive Files On-Demand provider process has stopped or become unresponsive. Files On-Demand is a Windows feature that shows OneDrive files as placeholders without downloading them locally.Resolution steps:
  1. Restart OneDrive: Right-click the system tray icon → Close OneDrive, then relaunch from the Start menu or by pressing Win + R and typing %localappdata%\Microsoft\OneDrive\OneDrive.exe.
  2. If the error persists, restart the Windows Storage Service:
  1. If the problem continues after restarting, reset OneDrive (see the Reset OneDrive section below).
Similar to 0x8007016A, this error indicates the OneDrive cloud file sync provider crashed during a sync operation, typically when a file was being opened or accessed.Resolution steps:
  1. Close all Office applications and any other programs that might have the affected file open.
  2. Restart OneDrive using the method above.
  3. If the error is tied to a specific file, move the file out of the OneDrive folder temporarily, let OneDrive sync, then move it back in.
  4. If the error recurs, reset OneDrive as described in the reset section below.
OneDrive cannot access a file or folder due to insufficient permissions. This often happens with files created by another user account or files locked by a system process.Resolution steps:
  1. Right-click the affected file or folder → Properties → Security.
  2. Confirm the current user account has Full Control or at minimum Modify permission.
  3. Click Advanced → Change (under Owner) to take ownership if necessary.
  4. Check if the file is locked by a running process using Sysinternals Process Explorer or Resource Monitor → CPU → Associated Handles.
The file name contains characters not supported by OneDrive or SharePoint (e.g., #, %, &, *, :, <, >, ?, /, \, |).Resolution steps:
  1. Identify the file from the OneDrive error list.
  2. Rename the file to remove unsupported characters.
  3. OneDrive will automatically retry the upload after the file is renamed.
Unsupported characters: " * : < > ? / \ | and names ending in a period or space.

​
Checking File Path Length Limits

Windows historically enforces a maximum file path length of 260 characters (the MAX_PATH limit). OneDrive adds its own restriction: the total path — including the OneDrive root folder path, all subfolders, the file name, and the file extension — must not exceed 260 characters.
1

Identify long paths

Use PowerShell to list all files in your OneDrive folder whose full path exceeds 260 characters:
2

Shorten affected paths

Move the affected files or folders closer to the root of the OneDrive folder, shorten subfolder names, or shorten file names. Aim to keep the total path under 255 characters to provide a safety margin.
3

Enable long paths in Windows (Windows 10 1607 and later)

For persistent environments with deep folder structures, you can enable long path support at the OS level via Group Policy:
Or via registry:
Enabling long paths requires applications to be built with long-path awareness. Not all third-party applications support this setting.

​
Pausing and Resuming Sync

Pausing sync is useful when you need to prevent OneDrive from uploading changes during a large file operation, a system migration, or while on a metered network connection.
1

Pause sync

Click the OneDrive system tray icon → click the Pause syncing option and select the pause duration: 2 hours, 8 hours, or 24 hours.
2

Resume sync manually

Click the OneDrive tray icon → click Resume syncing at any time before the pause duration expires.
3

Pause sync via Settings

For persistent pausing (e.g., while on a metered connection), open OneDrive Settings → Sync and backup → Pause sync on metered networks (Windows 11) or configure bandwidth settings under Settings → Network.

​
Resetting OneDrive

A full OneDrive reset clears the sync cache and forces OneDrive to re-establish its connection to the cloud. This resolves most persistent sync issues that cannot be fixed by restarting alone.
Resetting OneDrive disconnects your account from the sync client. Your files remain safely in the cloud — they are not deleted. After the reset, OneDrive will re-sync all files, which may take time depending on the number and size of files. Do not shut down the computer during re-sync.
1

Run the reset command

Press Win + R to open the Run dialogue and enter the following command, then click OK:
The OneDrive tray icon will disappear briefly. If it does not reappear within 60 seconds, proceed to the next step.
2

Manually restart OneDrive after the reset

If the OneDrive icon does not reappear automatically, press Win + R again and run:
3

Sign in again

When prompted, sign in with the user’s Microsoft 365 account. OneDrive will begin re-establishing sync for all folders.
4

Verify sync is progressing

Click the OneDrive icon and confirm the animated sync icon is visible. Allow sync to complete fully before testing file access.
If the reset command path does not work, the OneDrive executable may be in a different location. Locate it using:

​
Unlinking and Re-Linking Account

If a reset does not resolve the issue, or if the OneDrive account needs to be associated with a different Microsoft 365 account, unlink and re-link the account.
1

Unlink the account

Click the OneDrive system tray icon → Help & Settings (gear icon) → Settings → Account → Unlink this PC. Confirm by clicking Unlink account in the dialogue box.
2

Sign out of Microsoft 365 (optional but recommended)

If you are also reconfiguring the account, open any Office application, go to File → Account → Sign out, and remove the account from Credential Manager:
Remove any entries referencing MicrosoftOffice, OneDrive, or live.com.
3

Choose the OneDrive folder location

When OneDrive relaunches, you will be prompted to sign in and choose a sync folder location. You can keep the default (C:\Users\<Username>\OneDrive) or choose a different location. Keeping the original location allows OneDrive to match existing local files with cloud files, avoiding a full re-download.
4

Select folders to sync

If the user has a large OneDrive, use Choose folders during setup to selectively sync only the folders needed on this device, reducing bandwidth and disk usage.
5

Allow re-sync to complete

Monitor the OneDrive tray icon until the steady (non-animated) cloud icon confirms sync is complete.

​
Escalation

Microsoft Support

Raise a OneDrive support ticket at https://admin.microsoft.com → Support → New service request. Select OneDrive for Business as the product.

OneDrive Sync Logs

Before escalating, collect the OneDrive sync log files from %localappdata%\Microsoft\OneDrive\logs\. Attach SyncDiagnostics.log and recent ODSyncService logs to the support ticket.

Microsoft 365 Service Health

Verify there is no active OneDrive service incident at admin.microsoft.com → Health → Service Health.

Known Issues

Check the OneDrive release notes and known issues page for recently identified bugs that may match the reported error: https://support.microsoft.com/en-us/office/onedrive-release-notes-845dcf18-f921-435e-bf28-4e24b95e5fc0