Repair sync connections in OneDrive for Business

Sync errors can occur for several reasons with OneDrive for Business. Many errors can be fixed by using the Repair option in the OneDrive for Business menu that you can see from the system tray. Get started by right-clicking the the OneDrive for Business menu icon System tray warning icon for OneDrive for Business sync app in the system tray, and then clicking View sync problems in .

Sync problems initial dialog when you click on cloud icon

An error dialog box opens that describes any current sync problems and suggests actions you can take to fix them. Sometimes, you might prefer to just clear all sync errors at once, or you might see this error:

“An error occurred while attempting to synchronize this document library”

In either case, you can run Repair instead of trying to fix each sync error one at a time.

Note: There are many reasons why sync might fail. If this method doesn't fix the problem, check out the links in theStill having sync issues? section.

Run Repair on your libraries

  1. In the system tray, right-click or press and hold the OneDrive for Business menu icon System tray warning icon for OneDrive for Business sync app, and then click Repair.

    Repair dialog you get when you right click on cloud icon

  2. In the dialog box, click Repair.

    ODB Sync repair dialog

    Repair reports your progress until all sync connections are reset.

  3. Click Finish.

    Final One Drive for Business Sync repair dialog

Important:  Don’t restart your computer while Repair is running. If you have a timed auto-restart scheduled for your computer, postpone it until you’re sure Repair is finished.

If repairing your sync connection doesn't solve your problem, see "Method 2: Remove your OneDrive for Business cache" in the Microsoft Knowledge Base article: “An error occurred while attempting to synchronize this document library” error in OneDrive for Business

What happens when you run Repair?

Repair does the following:

  • Disconnects all libraries that were experiencing sync problems.

  • Reconnects these libraries. This means Repair downloads and syncs the current server version of each library, as if you were syncing for the first time.

  • Creates an archive copy of any file that had unsynced changes and places these files in a library folder under C:\users\username\OneDrive for Business archives\.

    If you change where your synced folders are stored, the archive folder may be called \OneDrive for Business -- Unsynced Changes\ when viewed in Explorer. At a CMD or DOS prompt, the folder is called ODBA. In that folder, OneDrive for Business creates subfolders with the current date and time as the folder name, such as \2016-02-16 15-03-09\ to store files that can't be synced.

    When Repair runs, it syncs the folder with the files that aren't causing the problems, and moves the other files into the archive. Repair creates these archive copies in case you had updates that couldn’t be synced to the server before you started Repair. This ensures that you don’t lose any local updates. You can compare file versions in the archive library folder with the reconnected folder to make sure you have the version you want.

When you're done with repair, the notification icon that signals sync problems should be clear. If it's not, click the OneDrive for Business notification icon System tray warning icon for OneDrive for Business sync app, click View sync problems. If there are no more issues to fix, click Dismiss in the OneDrive for Business dialog box.

Why don’t I see the Repair command?

The Repair command appears in the OneDrive for Business menu only if you're experiencing sync errors.

If you're experiencing sync errors but you still don’t see the Repair command, you might need to update the OneDrive for Business sync app.

Still having sync issues?

There can be a number of different reasons why OneDrive for Business fails to sync, from invalid characters in file names to out dated sync apps. Here are some links to help you troubleshoot OneDrive for Business sync issues:

Stop syncing a library

Before you can repair a sync issue, you need to stop syncing all folders.

When you stop syncing a folder, the folder is disconnected from its library. All files are retained in the previously synced folder. You can sync the library to your computer again at any time. When you start syncing a library again, it will create a new folder on your computer. If it's using the same name, it will add a number to the end, such as 1, 2, and so on.

  1. Right click the OneDrive for Business icon Stop syncinc a folder command in the OneDrive for Business menu

    Note: If the OneDrive for Business icon Button to see notification icons in the notification tray.

  2. Select the folder you want to stop syncing, and then click Stop syncing.

  3. Click Yes to agree to permanently stop syncing the folder, and then click OK.

To start syncing a library

You can start syncing your library again. When you start syncing a library again, it will create a new folder on your computer. If it's using the same name, it will add a number to the end, such as 1, 2, and so on.

  1. Sign in to Office 365 or your organization's SharePoint site with your work or school account.

  2. Select OneDrive at the top of the page. Or, select the app launcher Office 365 app launcher icon, and then select OneDrive.

    Office 365 navigation options

  3. Select the Sync button.

    The Sync button

    Note: If you don’t see a Sync button, select the Library tab and then select Sync in the Connect & Export group. (You may need to click Settings Sync option on the Library tab in the ribbon

  4. At the prompt, click Sync Now to start the sync app wizard. The wizard automatically fills in the name and web address of your OneDrive.

  5. Select Sync Now in the wizard to start syncing.

    You can click Show my files… in the wizard to open your OneDrive folder in File Explorer. The folder is listed in your Favorites as either OneDrive - CompanyName or as OneDrive @ CompanyName.

    You might see this in File Explorer...

    Or this...

    Synced OneDrive for Business folder in File Explorer

    Synced OneDrive for Business folder in File Explorer's Favorites

    When you're opening or saving an Office document, your screen looks similar to this:

    Saving a Word document to OneDrive for Business

Still need help?

Here's some more information.

Get help from the Office 365 community forums Admins: Sign in and create a service request Admins: Call Support

Was this information helpful?

How can we improve it?

How can we improve it?

To protect your privacy, please do not include contact information in your feedback. Review our privacy policy.

Thank you for your feedback!