Repair sync connections in OneDrive for Business

You can fix sync errors you get while you use the OneDrive for Business sync app by choosing View sync problems in the OneDrive for Business menu in the system tray.

View sync problems in the error resolution window

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.

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 choose Repair.
    Repair sync connections using the OneDrive for Business sync app

  2. In the dialog box, choose Repair.
    Screen shot of the Repair your OneDrive for Business Libraries dialog box
    Repair reports your progress until all sync connections are reset.

  3. Choose Finish.

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\.

    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.

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?

If you haven’t done so already, follow these steps to fix common OneDrive for Business sync issues, and see if that fixes your problem. Or, you can go directly to the OneDrive for Business Sync Issues Troubleshooting Guide. This tool can help guide you through diagnosing and resolving issues with libraries you’re currently syncing.

Still need help?

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

Applies To: SharePoint Online, Office 365, Office 365 Admin, Office 365 Small Business Admin, OneDrive for Business, SharePoint Server 2013 Enterprise, SharePoint Server 2013 Standard, SharePoint admin center, SharePoint Server 2016 Standard, SharePoint Server 2016 Enterprise

Was this information helpful?

Yes No

How can we improve it?

255 characters remaining

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

Thank you for your feedback!

Change language