Note To determine which OneDrive sync client you're using, see the following Microsoft website:
23 May 2018: Office integration (co-authoring and in-app sharing) now supported for Mac users.
If you want to sync from SharePoint on-premises environments or sync another user’s OneDrive library, 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.
|Invalid characters – These characters in file names aren't supported when you sync OneDrive for Business||<, >, :, ", |, ?, *, /, \|
|These file names aren't supported when you sync OneDrive for Business|| |
|These folder names aren't supported in OneDrive for Business|| |
|This folder name isn't supported when the folder is at the root level for a library||forms|
|Number of items that can be synced|| |
Although SharePoint Online can store 30 million documents per library, for optimum performance we recommend syncing no more than 300,000 files across all document libraries. Additionally, the same performance issues can occur if you have 300,000 items or more across all libraries you are syncing, even if you are not syncing all items in those libraries.
This is a suggested limit that is reliant on the length of file paths and hardware specifications of the device running the OneDrive app. Many customers are able to sync more files without experiencing any issues.
Note: If you are uploading, downloading, or moving a large number of files at once, you may need to wait an extended period of time before the sync process can complete. The client showing “syncing” icon or displaying "proecssing changes" during this period is not necessarily an indication of a problem. You can always click the OneDrive taskbar icon to see the status of content that is in the process of syncing. To help reduce sync times, we recommend reviewing and possibly modifying your bandwidth settings before starting your upload or download. You can also read how to Choose which OneDrive folders to sync to your computer.
There are other limits on viewing a document library using the web that may affect how you structure your files in OneDrive.
We encourage feedback as we are always working to optimize OneDrive to better handle libraries with a large number of files.
|Size limit for syncing files||There's a 15-gigabyte (GB) file size limit for each file that's uploaded to the OneDrive for Business library.|
|Character limit for files and folders|| |
In SharePoint Online, file name paths can have up to 400 characters. The limit may be less than 400 characters in some scenarios, especially if you have a very long URL path for the library.
|Sync folder location set to a network drive||You can't add a network or mapped drive as your OneDrive sync location.|
|Shared with Me||You can't synchronize the Shared with Me view grouping of files from a OneDrive for Business site.|
|Syncing with an external or guest account||Synchronizing content using an external or guest user is currently not supported by OneDrive|
Libraries with Information Rights Management enabled
Libraries can be synchronized as read/write with OneDrive build 17.3.7294.0108 or later.Syncing IRM-protected libraries isn't yet supported for Mac OS X.
|Elevated privileges||OneDrive can’t be run with elevated privileges.|
|Differential sync|| |
Differential sync is only possible for Microsoft Office files in the new file format, .docx, .pptx, .xlsx. OneNote files are not included.
This is part Office Integration and requires:
|Authenticated proxies||Authenticated proxies aren’t supported with the OneDrive for Business sync client.|
|Libraries with Checkout, Required columns or metadata, or when Draft Item Security is set to either Only users who can edit or Only users who can approve items in Version Settings of the library.|| |
For SharePoint document libraries, these items will be synchronized as read-only.
For OneDrive libraries, OneDrive will show an error and the user will not be able to synchronize the library until the mentioned settings have been removed.
|OneNote Notebooks||See below|
|Open files||See below|
|Lookup columns in a library||See below|
|Office integration||See below|
|Windows specific restrictions and limitations||See below|
|Mac OS X specific restrictions and limitations||See below|
|SharePoint Server on-premises||The onedrive.exe OneDrive for business sync client doesn’t support synchronization of SharePoint on-premises data. If you want to sync from SharePoint on-premises environments, you should use the previous OneDrive for Business application (groove.exe).|
|Symbolic or soft links|| |
OneDrive doesn't support symbolic links where the Link and Target are both located in the same library location.
This limitation doesn’t apply to co-authoring scenarios when you use the Microsoft Office applications described in the "Office integration" section.
The OneDrive for Business library can't exceed the lookup column threshold. For more information, go to the following Microsoft Knowledge Base article:
The OneDrive sync client for Windows supports co-authoring and in-app sharing when you use Office 2016 MSI and have the following update installed:
- 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 only supports users who can write to 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, Windows Server 2012, or Windows Server 2016 Remote Desktop Services (RDS). This includes both persistent and non-persistent Virtual Desktop Infrastructure (VDI).
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.
- OneDrive Files On-Demand is only supported on Windows 10 Fall Creators Update and later versions.
- Case-sensitive formatted disk volume isn't supported.
- OneDrive Files On-Demand isn't supported.
- Syncing IRM-protected libraries isn't yet 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.