Home › Knowledgebase › KB-056

OneDrive not syncing

Summary

This guide helps you troubleshoot and resolve: OneDrive not syncing. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

Overview

OneDrive sync issues can prevent your files from being available offline and cause collaboration problems. Follow these steps to diagnose and resolve OneDrive sync failures on Windows 10 and Windows 11.

Symptoms

Quick Fixes (Try These First)

Check OneDrive status

Look at the OneDrive cloud icon in your taskbar:

Restart OneDrive

  1. Right-click the OneDrive icon in the taskbar and select Quit OneDrive.
  2. Search for “OneDrive” in the Start menu.
  3. Open OneDrive to restart it.

Check Internet connection

If you are on a metered data plan, avoid starting large syncs or re-linking OneDrive until you are on an unlimited connection. Syncing large libraries can consume significant data.

Confirm sync is not paused

  1. Right-click the OneDrive icon and look for “Pause syncing”.
  2. If “Resume syncing” is shown, click it to restart the sync process.

Restart your computer

Restart your computer and allow OneDrive to restart automatically.

Verify Account and Client Status

Verify you are signed in

  1. Click the OneDrive icon → “Help & Settings” → “Settings”.
  2. On the “Account” tab, confirm the displayed account.
  3. OneDrive supports both Business (organisation) and consumer Microsoft accounts. If the wrong account is shown, click “Sign out” and then “Sign in” with the correct credentials.
  4. When multiple accounts are signed in, ensure the account you want to sync is the primary one.

Ensure the OneDrive client is up-to-date

OneDrive updates are delivered automatically through the Microsoft Store or via Click-to-Run for enterprise installations. There is no manual “Update” button within OneDrive settings.

The OneDrive sync app version may differ between Windows 10 and Windows 11 installations.

Check OneDrive service status

  1. Click the OneDrive icon in the taskbar to view the current status.
  2. If a red X or error badge is shown, note the error message.
  3. For known service outages, visit the Microsoft 365 service health page: Microsoft 365 service health. Small business customers without Microsoft 365 admin portal access can check this public page for service health.

Detailed Troubleshooting

Before proceeding, verify that you are running the latest OneDrive client and that your operating system updates are current.

Reset OneDrive

  1. Close OneDrive completely (right-click the icon → “Close OneDrive” or “Quit OneDrive”).
  2. Press Win + R to open the Run dialog.
  3. Enter the reset command: "%localappdata%\Microsoft\OneDrive\OneDrive.exe" /reset
  4. Press Enter and wait about one minute; OneDrive should restart automatically. If it does not, launch OneDrive from the Start menu.

If OneDrive was installed per-machine by your administrator, the path may differ. Contact IT support if the standard reset command does not work.

Clear OneDrive cache

  1. Close OneDrive completely.
  2. Press Win + R, type %localappdata%\Microsoft\OneDrive, and press Enter.
  3. Open the settings folder and delete its contents.
  4. Open the OneDrive folder and delete the cache folder if present.
  5. Restart OneDrive.

Clearing the cache will not delete your files stored in the cloud, but it may require OneDrive to re-scan your local files.

Unlink and re-link OneDrive

  1. Right-click the OneDrive icon → Settings.
  2. Open the Account tab.
  3. Click Unlink this PC.
  4. Sign back in with your Microsoft 365 credentials.
  5. Wait for files to re-sync.

Warning: Unlinking this PC will cause OneDrive to re-download all synced files when you sign back in. This can consume significant bandwidth and time, especially for large libraries or metered connections.

Check “Choose folders” (Selective Sync) settings

  1. Right-click OneDrive → Settings.
  2. Go to the Account tab and select Choose folders.
  3. Ensure the folders you need are ticked.
  4. Click OK.

Verify file and path restrictions

  1. Modern OneDrive supports file names and paths up to 400 characters. However, Windows API and NTFS limits (MAX_PATH) may still apply depending on your system configuration and long path support settings.
  2. File names that differ only by case (e.g., Report.docx vs report.docx) are treated as duplicates on OneDrive and can cause sync failures.
  3. Prohibited characters include \/:*?"<>| and any leading or trailing spaces.
  4. File types such as .tmp, .lnk, and certain executable extensions are blocked.
  5. Rename or relocate offending files, then retry syncing.

Check for large or problematic files

  1. OneDrive supports files up to 250 GB per file for most accounts.
  2. Avoid file names that contain any of the prohibited characters listed above.
  3. Close any programs that have the file open, then retry syncing.

Check for conflicting files

  1. Look for files with “(1)” or “conflict copy” appended to the file name in your OneDrive folder.
  2. These indicate OneDrive could not merge changes from multiple locations and created a conflict copy.
  3. Review both versions, keep the correct one, and delete or rename the conflict copy.

Check antivirus and security software

  1. Windows Defender or third-party antivirus software may block OneDrive from accessing files or network resources.
  2. Temporarily disable real-time protection to test if sync resumes.
  3. If sync works, add an exclusion for the OneDrive folder (typically %userprofile%\OneDrive) and the OneDrive executable in your security software.
  4. Re-enable protection after testing.

For guidance on managing security alerts, see Antivirus alerts: what to do.

Test network connectivity and proxy settings

  1. Confirm that ports 443 (HTTPS) are open on your firewall.
  2. If a proxy is used, ensure it allows traffic to *.sharepoint.com and *.onedrive.com.
  3. Verify VPN configurations do not block or route OneDrive traffic through restricted networks.
  4. If you are using a Telstra or Optus router, check that parental controls or security features are not blocking Microsoft 365 services.

Repair OneDrive via Windows Settings

  1. Open Settings → Apps → Installed apps.
  2. Locate Microsoft OneDrive in the list.
  3. Click the three dots (…) next to OneDrive and select Advanced options.
  4. Click Repair.
  5. If repair does not resolve the issue, click Reset.

Check OneDrive storage quota

  1. Click the OneDrive icon → “Help & Settings” → “Settings” → “Account”.
  2. Review the storage usage bar to see how much space is used and how much remains.
  3. If storage is full, OneDrive will stop syncing new files.
  4. Delete unnecessary files from OneDrive or upgrade your Microsoft 365 plan to increase storage.

When storage is full, sync will pause. Free up space or increase your quota before resuming large transfers.

SharePoint and Teams file sync considerations

If your business uses Microsoft Teams or SharePoint, files synced from SharePoint libraries or Teams channels use the OneDrive sync app. Issues with these locations may appear as OneDrive sync errors.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket