OneDrive Business Library Missing From the Sync Client Settings

You open OneDrive sync settings and cannot find your business library in the list of folders available to sync. The library appears in SharePoint Online but is absent from the sync client. This problem occurs when the library has been configured with a template that blocks sync, when site permissions are misconfigured, or when the library exceeds the sync limit of 500,000 items. This article explains the root causes and provides step-by-step fixes to restore the library to your sync client.

Why a Business Library Does Not Appear in OneDrive Sync Settings

A SharePoint document library can be missing from the OneDrive sync client for several technical reasons. The most common cause is a library template that is incompatible with sync. When a library is created from a custom list template or an enterprise wiki template, the sync client cannot read the library structure and hides it from the folder list. Another frequent cause is insufficient permissions. If the user has Read-only access to the site but not to the library individually, the sync client may show the site but omit the library. Third, the library may contain more than 500,000 items across all folders. OneDrive stops showing libraries that exceed this limit to prevent performance degradation. Finally, a tenant-wide sync restriction set by an administrator can block specific libraries from appearing. The sync client queries a list of syncable libraries from the SharePoint server. If any of these conditions exist, the server omits the library from that list.

Library Template Restrictions

SharePoint libraries created from certain templates mark the library as non-syncable. The sync client reads a metadata flag called SyncClientId on each library. If the library template does not set this flag or sets it to a disabled value, the client ignores the library. Common problematic templates include the Asset Library, the Picture Library, and any custom list template that was converted to a library. The fix requires changing the library template to the standard Document Library template or creating a new library from the correct template and moving the content.

Permission Gaps at the Library Level

SharePoint permissions are hierarchical but can be broken at any level. If a user has Contribute access to the site but the library has unique permissions that grant only Read access, the sync client shows the site but hides the library. The sync client requires at least Edit permission to sync a library. Check library permissions by navigating to the library in SharePoint, selecting the gear icon, choosing Library settings, and then clicking Permissions for this document library. If the user is not listed with Edit or Contribute, an administrator must grant the correct permission level.

Steps to Fix the Missing Business Library in OneDrive Sync

1. Verify the library template type
   In SharePoint Online, go to the site that contains the library. Select the gear icon and choose Library settings. Under General settings, look for Document Template. If the template is not “Microsoft Word document” or if the library type is Asset Library or Picture Library, the template is incompatible. Create a new Document Library and move files using SharePoint Designer or the Move to command.
2. Check library permissions
   In Library settings, click Permissions for this document library. If the page says “This library inherits permissions from its parent,” click Stop Inheriting Permissions and add the user with Contribute or Edit access. If permissions are already unique, verify the user is listed with at least Contribute. Add the user if missing.
3. Count items in the library
   Open the library in SharePoint. Click the gear icon and choose Library settings. Under General settings, look for the item count displayed at the top of the page. If the count is 500,000 or more, the library exceeds the sync limit. Reduce the item count by archiving old files to a separate library or by using retention policies to delete expired content.
4. Clear the OneDrive sync cache
   Close OneDrive completely. Press Windows key + R, type %localappdata%\Microsoft\OneDrive\settings\Business1 and press Enter. Delete all files and folders inside the Business1 folder. Restart OneDrive. Sign in again and check if the library appears in the sync settings.
5. Manually add the library from SharePoint
   Open the SharePoint site in a browser. Navigate to the missing library. Click the Sync button in the toolbar. If the library is syncable, OneDrive will open and prompt you to sync that specific library. This bypasses the client-side folder selection dialog and forces the server to re-evaluate the library.
6. Check tenant sync restrictions
   Sign in to the Microsoft 365 admin center as a global admin. Go to SharePoint admin center > Policies > Access control. Under Device access, ensure that “Block sync on all libraries” is not enabled. Also verify that the specific library is not listed under Blocked file types or Blocked sync on specific sites. If a restriction is active, remove the library from the blocked list.

If OneDrive Still Does Not Show the Library After the Main Fix

OneDrive Sync Client Version Is Outdated

Older versions of the OneDrive sync client do not support certain library features like large metadata columns or custom content types. Update OneDrive by downloading the latest version from the Microsoft 365 portal. After updating, restart the computer and try adding the library again.

Library Has an Unsupported Column Type

Columns of type Managed Metadata, External Data, or Lookup to another list can prevent a library from syncing. In Library settings, click Column settings and check for any columns that use these types. Remove or replace the column with a Choice or Single line of text column. After the change, the library should appear in the sync client within 30 minutes.

Site Collection Is Set to No-Browser or Restricted Mode

If the SharePoint site collection has the No-Browser feature enabled, the sync client cannot render the library. This feature is typically used for publishing sites. Go to Site settings > Site collection features. If the feature “SharePoint Server Publishing Infrastructure” is active, deactivate it or create a new site collection without this feature. Move the library to the new site.

Document Library vs Asset Library: Sync Client Behavior

Item	Document Library	Asset Library
Template type	Document Library (100)	Asset Library (851)
Sync support	Full support	Not supported
Max items before sync hides library	500,000	N/A (always hidden)
Workaround to sync	Reduce item count or use Known Folder Move	Create a Document Library and move assets manually

If your library is an Asset Library, the only solution is to create a new Document Library and move the files using SharePoint Designer or the Move to command. The Asset Library template is designed for rich media management and does not support the sync protocol.

Conclusion

A missing business library in OneDrive sync settings is usually caused by an incompatible template, insufficient permissions, or an excessive item count. By checking the library template type, verifying permissions, and reducing the item count, you can restore the library to the sync client. If the library still does not appear, clearing the sync cache or manually syncing from SharePoint often resolves the issue. For persistent cases, update the sync client and remove unsupported column types. You can also use the OneDrive admin reports in the Microsoft 365 admin center to audit which libraries are blocked from sync across your tenant.