OneDrive Admin Checklist: shared library sync stays pending for large document libraries

When you sync a shared library in OneDrive, the sync status may show “Pending” for hours or even days, especially if the library contains tens of thousands of files. This problem occurs because the OneDrive sync engine has a built-in limit on the number of items it can process in a single sync relationship. This article explains the technical limits that cause the pending state, provides a step-by-step admin checklist to resolve it, and lists related failure patterns you may encounter with large libraries.

Why Shared Library Sync Stays Pending for Large Libraries

The OneDrive sync client uses the SharePoint search index to discover changes in a library. When a library contains more than 300,000 items across all folders, the sync client cannot enumerate the full file list within the time window it allocates. The sync engine then enters a pending state while it retries the enumeration operation repeatedly.

A second technical factor is the SharePoint list view threshold of 5,000 items. If any single folder or metadata view in the library exceeds 5,000 items, the sync client cannot retrieve the folder contents. This causes the sync to stall on that specific folder, and the entire library sync shows as pending.

A third factor is the number of sync relationships per user. OneDrive allows a maximum of 5 shared libraries to be synced simultaneously. When a user already syncs several libraries, adding a large library pushes the client over its concurrent sync capacity, leading to a pending state.

Admin Checklist: Steps to Fix Pending Sync for Large Libraries

1. Check the library item count
   Open SharePoint admin center > Active sites. Select the site that contains the library. Go to Site contents > library name. At the bottom of the library page, look for the item count. If the count exceeds 300,000, the library is too large for sync. Reduce the item count by archiving older files to a separate library or moving files to a different site.
2. Split the library into multiple smaller libraries
   Create a new document library on the same site. Move files by year, department, or project into the new library. Each library must stay under 300,000 items. After moving, ask the user to sync the new library instead of the original one.
3. Check folder item counts against the 5,000-item threshold
   Open the library in SharePoint. Sort by folder. Expand each folder and check the item count at the bottom of the folder view. Any folder with more than 5,000 items will cause sync to hang. Create subfolders inside that folder so each subfolder stays under 5,000 items.
4. Add indexed columns to the library
   Go to Library settings > Indexed columns. Add columns that users commonly use for sorting or filtering, such as “Modified” or “Created”. Indexed columns help the sync client query the library without hitting the 5,000-item view threshold.
5. Reduce the number of synced libraries per user
   Open OneDrive admin center > Sync. Under “Limit syncing to specific shared libraries”, set the maximum number of libraries a user can sync. Advise users to stop syncing libraries they no longer need. Go to OneDrive settings > Account > Stop sync on the unused library.
6. Block large file types from syncing
   In OneDrive admin center > Sync > File type blocking, add file extensions such as .zip, .iso, .psd, and .mov. Blocking these file types prevents the sync client from downloading them, which reduces the total item count that must be processed.
7. Reset the OneDrive sync client
   Press Windows key + R, type onedrive.exe /reset, and press Enter. Wait 2 minutes. Press Windows key + R again, type onedrive.exe, and press Enter. This clears the local cache and forces a full resync. Only use this step after reducing the library size, or the pending state will return.
8. Enable sync health reports in the admin center
   Go to OneDrive admin center > Health > Sync health. Turn on “Sync health reports”. These reports show which users have libraries that exceed the sync limits. Use the reports to proactively identify large libraries before users report pending sync.

If OneDrive Still Shows Pending After the Main Fix

OneDrive shows “Pending” for a newly created library

A new library may show pending if the SharePoint search index has not finished crawling it. Wait 24 hours for the index to complete. If the pending state persists, ask the site owner to run a manual index request: go to Library settings > Advanced settings > Reindex document library. This triggers a full crawl within 2 hours.

OneDrive sync stops at a specific percentage and shows pending

This indicates that one file or folder is blocking the sync. Open OneDrive > View sync issues. Look for files with names longer than 400 characters, paths longer than 400 characters, or files that contain invalid characters like " : < > ? / \ |. Rename or delete the problematic file. Then pause and resume sync from the OneDrive icon in the taskbar.

OneDrive shows pending for a library that previously synced fine

The library may have grown over the 300,000-item limit due to new file uploads. Check the library item count again. If the count is near the limit, ask users to stop uploading new files until you archive older files. Alternatively, create a new library and move the oldest files there.

OneDrive shows pending on a shared library but not on the user’s own OneDrive

Shared libraries use a separate sync relationship. Each relationship consumes memory and processing resources. If the user syncs 4 or 5 shared libraries, the client may not have enough resources to process a large library. Ask the user to stop syncing one or two shared libraries. Then restart OneDrive from the taskbar icon.

OneDrive Shared Library Sync: Large vs Small Library Behavior

Item	Large library (over 300,000 items)	Small library (under 100,000 items)
Sync startup time	Shows pending for 30 minutes to 24 hours	Completes within 5 minutes
File enumeration method	Relies on SharePoint search index; may fail if index is stale	Uses direct list query; completes quickly
Folder view threshold risk	High; any folder with 5,000+ items blocks sync	Low; folders rarely exceed 5,000 items
Admin intervention needed	Yes; must reduce item count or split library	No; sync works without changes
Sync health report visibility	Triggers alert in sync health reports	Does not trigger alert

Now you can identify why a shared library sync stays pending and apply the correct fix based on the library size. Start by checking the library item count in SharePoint admin center. If the count exceeds 300,000, split the library into smaller libraries. For folders that exceed 5,000 items, add indexed columns or create subfolders. Enable sync health reports in the OneDrive admin center to catch large libraries before users report issues. As an advanced tip, configure a retention policy in Microsoft 365 compliance center to automatically archive files older than 5 years to a separate library, keeping the active library under the 300,000-item limit.