Get started syncing SharePoint sites with the new OneDrive sync client

You can use the new OneDrive sync client to sync files from SharePoint document libraries to your PC or Mac.

The latest release of the new OneDrive sync client lets you:

  • Navigate to a SharePoint Online site, a folder, or a shared folder, and click Sync to sync files to the computer. No need to sync the entire document library.

  • Change the folders that you're syncing directly in the sync client.

  • Sync shared folders.

  • Sync read-only files and folders.

  • Edit files with other people at the same time with Office 2016 (requires click-to-run build 16.0.7167.2xxx or MSI build 16.0.4432.100x). For more information about installing Office 365, see Install Office on your PC or Mac.

  • Automatically transition from the previous OneDrive for Business sync client (Groove.exe) to the new OneDrive sync client. (For more information on how this works, see Transition from the previous OneDrive for Business sync client.)

Note: The new OneDrive sync client now supports Windows 10, Windows 8.1, Windows 8, and Windows 7. The new OneDrive sync client doesn't yet support syncing on-premises instances of OneDrive for Business (when your organization doesn't subscribe to an Office 365 business plan).

Before you begin

Ask your admin to test out syncing SharePoint sites and enable it for you. If you're the IT admin for your organization, see Enable users to sync SharePoint files with the new OneDrive sync client.

Syncing files

Once you've installed the sync client, you're ready to sync files. There are two ways to do this:

  • Sync the entire library    If you go to a SharePoint site and click Documents, you can sync the entire document library by clicking Sync.

  • Sync only the files and folders that you want     You can navigate to specific subfolders within a document library and click Sync to sync just those files and folders.

To sync libraries and folders
  1. On the Office 365 app launcher, choose SharePoint.

  2. Click the site that you want to sync.

  3. Click Documents or navigate to the subfolder that you want to sync.

  4. Click Sync, and then choose Sync now.

    Screenshot showing Sync button on a SharePoint library.
  5. If your browser requests permission to use "Microsoft OneDrive," confirm that this is okay.

    Note: If you see either the OneDrive Setup wizard or a dialog box asking "Which library do you want to sync?" after clicking “Allow” in Internet Explorer, your site has not been set up. Contact your IT department or see Enable users to sync SharePoint files with the new OneDrive sync client.

  6. Choose the folders that you want to sync, and then click Start sync.

    Screenshot of dialog box allowing configuration of which folders to sync.

SharePoint team sites sync under a folder that has the name of your organization. This folder is automatically added to the left navigation pane in Windows File Explorer.

Screenshot showing sync folders for OneDrive and sites.

Manage your syncing sites   

You can manage your syncing sites in the sync client settings. Open Settings by right clicking on the blue cloud icon in your system tray and selecting Settings. Click the Account tab to see a list of all your syncing sites.

Screenshot of account settings in the OneDrive sync client.

Windows

Screenshot of the Account tab on the OneDrive sync client for the Mac

Mac

If you want to change the folders that you're syncing, click Choose folders for that library, and then choose the folders that you want to sync.

To stop syncing a site, click Stop sync next to the site. (Copies of the files remain on your computer. You can delete them if you want.)

Known issues

The following are known issues in this release:

  • SharePoint team sites sync per computer. Like OneDrive, team site sync relationships are per computer (i.e., pressing the sync button from one computer will not automatically start that team site syncing on another computer, even if they are both configured to sync OneDrive. You must configure your sync settings separately on each computer where you want to sync files.

  • When syncing libraries that require check out, or libraries with required columns or metadata, the files are synced as read-only. If you do make changes to these files, the changes will not be synced back to Office 365.

  • Version history is lost when moving Office files locally across sites. To move Office files to another site, go to Office 365 and use "Copy to" to copy your files to another site.

  • OneNote files can't be moved locally across syncing sites. To move OneNote notebooks to another site, use the copy feature in the OneNote app.

  • Watch out for site names that include “:” or any non-supported folder name character on Windows. The new OneDrive sync client can't sync sites with names that include these unsupported folder name characters.

  • When you sync a SharePoint site or folder, a new folder is created in the folder that has the name of your organization (for example, %userprofile%\Contoso). You cannot reuse an existing folder.

  • There is a known issue in Edge where site setup navigates you to a support page instead of launching site setup. Please make sure you are running the latest version of Windows which has the latest fix.

  • Folders might be moved around after transitioning from the previous OneDrive for Business sync client (Groove.exe) to the new OneDrive sync client. The new OneDrive sync client does not sync folders to which you have no permissions. If you were syncing folders with the previous OneDrive for Business sync client to which you had no permissions, the new sync client will remove those folders and move any content within to the root of the folder with the name of your organization.

Get Support

If you run into any issues, please let us know:

  1. Right-click the blue OneDrive icon in the navigation area, at the far right of the taskbar.

  2. Click Report a problem.

  3. Include a brief description of your issue and then click OK.

You will receive an email notification with a support ticket number to track your issue.

Share Facebook Facebook Twitter Twitter Email Email

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!

×