How to fix OneDrive’s document library synchronization error

by Tashreef Shareef
Tashreef Shareef
Tashreef Shareef
Windows & Software Expert
Tashreef Shareef is a software developer turned tech writer. He discovered his interest in technology after reading a tech magazine accidentally. Now he writes about everything tech from... read more
Affiliate Disclosure
OneDrive unable to synchronize this document library error

To fix Windows PC system issues, you will need a dedicated tool

  • Download Fortect and install it on your PC
  • Start the tool's scanning process to look for corrupt files that are the source of your problem
  • Right-click on Start Repair so the tool can start the fixing algorithm
Download Now Fortect has been downloaded by 0 readers this month, rated 4.4 on TrustPilot

OneDrive sync errors can occur for several reasons. While Microsoft offers a built-in repair tool with OneDrive for Business, it may not be able to fix all the errors. One such bug is An error occurred while attempting to synchronize this document library.

Several users have reported similar errors in the Microsoft community forum as well:

Hi, I am receiving this error when attempting to synchronize my OneDrive for Business library – and I have no idea why.

If you are also troubled by this error, this is the article that you need. In this guide, we have listed a couple of troubleshooting tips to help you resolve syncing issues with OneDrive for Business.

How do I fix the document library sync error in OneDrive?

1. Update the OneDrive client

1.1 Update with Office 365

error occurred while attempting to synchronize this document library

  1. Launch any Microsoft Office app like MS Word
  2. Click on File and select Account
  3. Under Office Updates, click Update Options.
  4. Select Update Now
  5. Wait for Microsoft Office updates to download and install
  6. Launch OneDrive and check for any improvements

1.2 Update standalone installer

error occurred while attempting to synchronize this document library

If you have installed a standalone installer, you may have to install the updates manually:

  1. Click on the OneDrive icon on the taskbar
  2. Click the arrow icon to show hidden icons
  3. On top of the panel, check if it says updates are available
    • Download and install the updates if available.
  4. If it says OneDrive is Up to date, skip the step

After installing the update, reboot the computer before relaunching the OneDrive client.

2. Clear OneDrive cache

error occurred while attempting to synchronize this document library

Note: These steps are for OneDrive for Business users. We haven’t tested it with OneDrive consumer client.

  1. Make sure you have the backup of unsynced files on the OneDrive folder
  2. Click the small arrow icon on the Taskbar to show hidden icons
  3. Right-click on OneDrive and select Pause Sync
  4. Right-click on the OneDrive icon again and select Close OneDrive
  5. Open the Task Manager and close all the Microsoft Office processes
  6. Open File Explorer and navigate to the following location:
  7. Now click on the numbered folder, which indicates the office version
  8. Next, open the OfficeFileCache folder
  9. Delete all the files inside the OfficeFileCache folder.
    • Don’t delete the folder itself, but only the files inside
  10. Close File Explorer and open OneDrive client and check for any improvements

3. Reset OneDrive clientreset onedrive


  1. Click on Start and select Settings
  2. Go to Apps > Apps and Features
  3. Search for OneDrive
  4. Click on OneDrive and then click on Advanced
  5. Scroll down and click on Reset
  6. Click Reset again to confirm the action
  7. Alternatively, you can also reset OneDrive by running a command
  8. Press Windows Key + R to open Run
    error occurred while attempting to synchronize this document library
  9. Type the following command and hit enter:
    %localappdata%MicrosoftOneDriveonedrive.exe /reset
  10. Open OneDrive and check for any improvements.

If you’re having trouble opening the Setting app, take a look at this article to solve the issue.

The An error occurred while attempting to synchronize this document library issue can occur due to an outdated version of OneDrive or because of the bad cache. Carefully follow the steps in this article to fix the OneDrive sync issue quickly.

Have you also encountered this OneDrive error? Tell us how you managed to fix it in the comment section below.


This article covers:Topics: