SharePoint Document Issues

Fix SharePoint Library Sync Opening the Legacy OneDrive Client

Steven ParkerSteven Parker Nov 20, 2026 869 views

Question details

Use the modern OneDrive sync client to sync a SharePoint library instead of the legacy OneDrive for Business client.

Fix SharePoint Library Sync Opening the Legacy OneDrive Client
Product
SharePoint and OneDrive for Business
Device & OS
Windows 10
Scenario
A user selects Sync in a SharePoint document library and wants the library to connect to the modern OneDrive client.
Observed behavior
The SharePoint Sync action opens the legacy Groove.exe client instead of the modern OneDrive sync client.
Before you start

Check that the modern OneDrive client is installed and signed in with your work or school account. If your organization manages SharePoint settings or Windows registry changes, contact your administrator before proceeding.

Solution 1Recommended

Enable modern OneDrive sync and take over the library connection

Use this approach for an older SharePoint and OneDrive configuration that still routes library sync requests to Groove.exe.

The registry value and takeover command were used with older OneDrive deployments. They may not be needed or available in current versions; if the settings or command are unavailable, ask your Microsoft 365 administrator to check the current sync configuration.

1
Check the SharePoint sync setting

If you are an administrator, open the SharePoint admin center and check Settings for the OneDrive sync client setting. Where the legacy setting is available, enable the modern sync client for SharePoint libraries. Non-administrators can ask an administrator to check it.

2
Set the team site sync value

Open Start, search for Registry Editor, and navigate to HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive. Create or edit the DWORD (32-bit) value TeamSiteSyncPreview and set its value data to 1. Change only the specified value.

3
Exit OneDrive

Select the OneDrive cloud icon in the Windows notification area, open Help & Settings or the gear menu, and choose Quit OneDrive or Exit OneDrive.

4
Run the takeover command

Open Command Prompt from Start and run "%localappdata%\Microsoft\OneDrive\OneDrive.exe" /takeover. If the command is not supported by your installed client, contact your administrator for the current migration procedure.

5
Sync the library again

Open the SharePoint document library in your browser, select Sync, and allow the browser to open OneDrive. Sign in with your work or school account if prompted, then check the OneDrive cloud icon for sync status.

Enable modern OneDrive sync and take over the library connection
Registry changes and managed devices: Registry Editor changes can affect Windows or application behavior. If you cannot edit the value or your device is managed, ask your IT administrator for help.
Free Microsoft Office alternative

Work with SharePoint Documents Using WPS Office

WPS Office is a free, lightweight alternative for opening and editing downloaded or locally synced Office documents. Its familiar interface and format compatibility make it easy to move between Office apps, although it does not repair SharePoint or OneDrive sync.

Open and edit local copies of documents from a SharePoint library.Work with Microsoft Office formats, including DOCX, XLSX, and PPTX.Use a familiar interface to make the transition from Microsoft Office easier.Access essential document tools in a free, lightweight office suite.
microsoft office alternative - wps office

Frequently Asked Questions

Why does SharePoint open Groove.exe when I select Sync?

Groove.exe is the legacy OneDrive for Business sync client. An older SharePoint or OneDrive configuration may still direct library sync requests to it instead of the modern OneDrive client.

Do I need to be a SharePoint administrator to fix this?

An administrator may need to check the SharePoint admin center sync setting. A user may be able to apply the per-user registry value and run the takeover command, depending on device permissions and organizational policies.

Where do I set TeamSiteSyncPreview?

In Registry Editor, go to HKEY_CURRENT_USER\SOFTWARE\Microsoft\OneDrive and create or edit the DWORD (32-bit) value TeamSiteSyncPreview. Set its value data to 1. This is a legacy configuration step and may not be needed with current clients.

What should I do if the takeover command does not work?

Confirm that OneDrive is installed under %localappdata%\Microsoft\OneDrive and that you exited it from the notification-area menu. If the installed version does not support /takeover, ask your administrator for the current migration procedure.

Can WPS Office fix the SharePoint sync connection?

No. Configure SharePoint and OneDrive to fix the sync connection. WPS Office can open and edit compatible files after they are downloaded or synced locally.