Restrictions and limitations when you sync files and folders using the new OneDrive for Business sync client

INTRODUCTION
This article contains information about the restrictions and limitations that apply when you use OneDrive for Business (onedrive.exe) or OneDrive for Business for Mac OS X to sync SharePoint Online OneDrive for Business libraries to your computer.

Note To determine which OneDrive sync client you're using, see the following Microsoft website:If you're looking for restrictions and limitations that apply to the earlier version of OneDrive for Business (groove.exe), see the following Microsoft Knowledge Base article:
2933738 Restrictions and limitations when you sync SharePoint libraries to your computer through OneDrive for Business
MORE INFORMATION

Supported libraries

If you're using the preview build of the OneDrive for Business Next Generation sync client, you can now sync SharePoint Online document libraries from team sites. For more information about this functionality and how to set up team site sync using the preview version of the OneDrive for Business Next Generation sync client, see the following Microsoft website: 

Note Unless you're using the preview version of the sync client, you can’t sync SharePoint Online document libraries within team sites. 

If you want to sync from SharePoint on-premises environments, sync another user’s OneDrive library, or sync SharePoint Online document libraries from team sites without using the preview sync client, you should use the previous OneDrive for Business application (groove.exe).

Both the onedrive.exe and groove.exe clients can run at the same time.

Limitations

Invalid characters – These characters in file names aren't supported when you sync OneDrive for Business

#, %, <, >, :, ", |, ?, *, /, \
These strings in file names aren't supported when you sync OneDrive for Business.files
~$
._
.laccdb
.tmp
.tpm
thumbs.db
EhThumbs.db
Desktop.ini
.DS_Store
Icon
.lock
CON
PRN
AUX
NUL
COM1
COM2
COM3
COM4
COM5
COM6
COM7
COM8
COM9
LPT1
LPT2
LPT3
LPT4
LPT5
LPT6
LPT7
LPT8
LPT9
These folder names aren't supported in OneDrive for Business_t
_w
This folder name isn't supported when the folder is at the root level for a libraryforms
Number of items that can be syncedSharePoint Online has a limit of 30 million documents per library. There are other limits on viewing a document library by using the web that may limit how you structure your files in OneDrive.
Size limit for syncing filesThere's a 10-gigabyte (GB) file size limit for each file that's uploaded to the OneDrive for Business library.
Character limit for files and foldersIn SharePoint Online, file name paths can have up to 256 characters. The limit may be less than 256 characters in some scenarios, especially if you have a very long URL path for the library.
Sync folder location set to a network driveYou can't add a network or mapped drive as your OneDrive sync location.
Shared with MeYou can't synchronize the Shared with Me view grouping of files from a OneDrive for Business site.
Elevated privilegesOneDrive can’t be run with elevated privileges.
Differential syncOneDrive for Business doesn’t support differential sync.
Authenticated proxiesAuthenticated proxies aren’t supported with the OneDrive for Business sync client.
OneDrive Libraries with Checkout or IRM enabledOneDrive doesn’t support syncing libraries that require checkout or libraries that are protected by Information Rights Management (IRM).
OneNote NotebooksSee below
Open filesSee below
Lookup columns in a librarySee below
Office integrationSee below
Windows specific restrictions and limitationsSee below
Mac OS X specific restrictions and limitationsSee below


OneNote notebooks

Because OneNote notebooks have their own sync mechanism, they aren't synced by the OneDrive for Business sync client. Instead, you should save your OneNote files through OneNote or the web to OneDrive. OneDrive will create a stub file in your sync folder, depending where you saved the OneNote file.

Open files can't be synced

A file that’s currently opened by an application can't be synced by OneDrive for Business. To sync the file, close any application where the file is currently being used, and then sync the file.

This limitation doesn’t apply to co-authoring scenarios when you use the Microsoft Office applications described in the "Office integration" section.

Lookup columns in a library


The OneDrive for Business library can't exceed the lookup column threshold. For more information, go to the following Microsoft Knowledge Base article:
2927386 "We couldn’t sync this library" error when you use the OneDrive for Business sync client

Office integration


The OneDrive sync client for Windows supports co-authoring and in-app sharing when you use Office 2016 Click 2 Run (version 16.0.6741.2027 or higher). You must also have OneDrive (version 17.3.6386.0412 or higher). Integration with Office 2016 MSI is coming later this year. Office integration isn't currently supported for the Mac OS X version.

Windows specific restrictions and limitations

  • Windows Explorer displays the first 35 characters of a site library’s name and site name combination for a library that you have synchronized. This doesn’t affect the ability to sync these items within the limits that are described in this article.
  • Roaming, Mandatory and Temporary Windows profiles aren't supported. The OneDrive for Business sync app isn't supported in any configuration that doesn't let the user account write to the OneDrive for Business application directories.

    Additionally, the OneDrive for Business sync app isn’t supported for client sessions that are hosted on Windows 2008 Terminal Services or Windows 2012 Remote Desktop Services (RDS).

    For the OneDrive for Business sync app to work as designed, the following requirements must be met:
    • The application must be installed on the local computer.
    • The user must be able to write to the user profile.
    • Data that's written to the user profile must be saved to the local hard disk and be available without a network connection.

Mac OS X specific restrictions and limitations

  • Case-sensitive formatted disk volume isn't supported.
  • Office integration (co-authoring and in-app sharing) isn't currently supported.

Microsoft Support and Recovery Assistant for Office 365

The Microsoft Support and Recovery Assistant for Office 365 is a tool which can diagnose and fix many common Office 365 problems. The OneDrive for Business option I’m having a problem with OneDrive for Business now scans for the following issues:
  • Checks the option to manually or automatically update the NGSC+B to its latest version.
  • Reports all files that have sizes exceeding the limit.
  • Reports all files that have invalid characters in the names.
  • Reports all folders that have invalid characters or strings in the names.
  • Reports all paths exceeding the limit and provides a link to this KB article.
The tool is available from http://diagnostics.outlook.com. When you run this tool, the initial page will display several options, including the new option for OneDrive for Business - I’m having a problem with OneDrive for Business.

Still need help? Go to Microsoft Community.
Properties

Article ID: 3125202 - Last Review: 11/22/2016 22:33:00 - Revision: 18.0

OneDrive for Business, Microsoft SharePoint Online

  • o365 KB3125202
Feedback