OneDrive for Business shared library sync stays pending for hybrid teams: Fix Guide

When hybrid team members sync a shared library in OneDrive for Business, the sync status may remain stuck on Pending for hours or days. This prevents users from seeing the latest files and blocks offline access. The root cause is typically a mismatch between the local sync app version, the SharePoint Online library size, or a network proxy that interferes with the sync protocol. This guide explains why the Pending state occurs and provides a structured fix for IT administrators and end users in hybrid work environments.

Why OneDrive Shared Library Sync Gets Stuck on Pending

OneDrive for Business uses a dedicated sync engine that communicates with SharePoint Online through HTTPS. When a shared library is added to sync, the engine first enumerates all files and folders in that library. If the library contains more than 100,000 items or individual files larger than 250 GB, the enumeration process can time out and leave the sync in a Pending state. The sync engine waits for a server response that never completes.

Hybrid teams add another layer of complexity. Users who connect from a corporate network through a VPN or proxy may experience packet loss or SSL inspection that breaks the sync protocol. The sync app sees a partial response and marks the library as Pending. Additionally, if the user has multiple identities cached in Windows Credential Manager, the sync engine may try the wrong credential and fail silently.

Another frequent cause is a mismatch between the OneDrive sync app version and the SharePoint Online tenant. Microsoft updates the sync protocol regularly. If the local app is more than two versions behind, the server may reject the sync request and send a Pending status. The sync app does not always display an error message in this scenario.

Steps to Clear the Pending Sync State on a Shared Library

The following steps apply to Windows 10 and Windows 11 devices. Perform them in the order listed. After each step, check whether the Pending status changes to Syncing or Up to date.

1. Pause and resume sync for the shared library
   Right-click the OneDrive cloud icon in the system tray. Select Help & Settings > Pause sync > 2 hours. Wait 30 seconds, then right-click again and select Resume sync. This forces the sync engine to reattempt the library enumeration without restarting the app.
2. Remove and re-add the shared library from sync
   Right-click the OneDrive cloud icon and select Settings. Go to the Account tab. Under Shared libraries, locate the library that shows Pending. Click Stop sync. Confirm the action. Then click Add a shared library, search for the same library, and select Sync. This creates a fresh sync token and clears any corrupted local state.
3. Clear cached OneDrive credentials from Windows Credential Manager
   Open Control Panel and select Credential Manager. Click Windows Credentials. Scroll to the Generic Credentials section. Look for entries that start with OneDrive Cached Credential or MicrosoftOffice15_Data:ADAL:. Click the arrow to expand each entry and select Remove. Restart OneDrive. The app will prompt for credentials again on the next sync attempt.
4. Reset the OneDrive sync app
   Press Windows key + R, type onedrive.exe /reset, and press Enter. Wait for the OneDrive setup window to reappear. Sign in again with the same work or school account. After the reset, re-add the shared library from the Account tab. The reset clears all cached sync metadata but does not delete local files.
5. Disable proxy or VPN temporarily for testing
   If the user connects through a corporate VPN, disconnect it. Open Windows Settings > Network & Internet > Proxy. Turn off Use a proxy server. Restart OneDrive and check the sync status. If the library starts syncing, the proxy or VPN is interfering. Whitelist the OneDrive endpoints in your firewall or proxy configuration.
6. Update the OneDrive sync app to the latest version
   Right-click the OneDrive cloud icon and select Settings. Go to the About tab. Note the build number. Open a browser and go to the OneDrive release notes page. Compare the build with the latest production version. If the local version is older, download the latest OneDrive installer from the Microsoft 365 admin center and run it. Restart the device after the update.

If OneDrive Still Shows Pending After the Main Fix

OneDrive shared library Pending after re-adding the library

If the library remains Pending after following the steps above, check the SharePoint Online library size. Open a browser and navigate to the library. At the bottom of the page, look for the total item count. If the library has more than 100,000 items, the sync engine may take several hours to enumerate. Use the Sync button in the browser instead of the OneDrive app to initiate a fresh sync. If the count exceeds 500,000 items, break the library into smaller folders and sync each folder separately.

OneDrive shows Pending for all shared libraries but personal library works

This pattern indicates a permissions issue on the SharePoint site collection. The user may have been removed from the site members group but still has a cached sync relationship. Ask the SharePoint administrator to verify the user’s permissions in the site collection. If the user is listed as a visitor or has no explicit permissions, remove the library from OneDrive sync and re-add it after the administrator grants at least Edit level access.

OneDrive Pending on a hybrid team member’s home network but works in the office

Network configuration differences cause this behavior. The home network may have a router that blocks WebSocket connections, which OneDrive uses for real-time sync. Ask the user to open a command prompt and run nslookup config.office.com. If the lookup fails or returns a non-Microsoft IP address, the DNS resolver is misconfigured. Change the DNS server to 8.8.8.8 temporarily and test the sync again.

Files On-Demand vs Always Keep on This Device: Impact on Pending Sync

Item	Files On-Demand	Always Keep on This Device
Description	Placeholder files are downloaded only when opened	All files in the folder are downloaded and kept offline
Impact on Pending state	Reduces enumeration time for large libraries because metadata is fetched first	Increases enumeration time because the engine must download each file header
Recommended for hybrid teams	Yes, especially for libraries with more than 10,000 items	No, unless the user needs all files offline and has a fast connection
How to switch	Right-click the shared library folder in File Explorer > Always keep on this device to toggle off	Right-click the shared library folder > Always keep on this device to toggle on

For hybrid teams, Files On-Demand is the better choice. It prevents the sync engine from attempting to download every file during the initial enumeration, which is the most common trigger for the Pending state. Users can still mark individual folders as Always keep on this device if they need offline access to specific project files.

After applying the fixes in this guide, the shared library should transition from Pending to Syncing within 15 minutes. If the status does not change, run the OneDrive sync troubleshooter built into Windows 11 by searching for Find and fix problems with OneDrive in the Settings app. As an advanced step, IT admins can use the SharePoint Online Management Shell to run Set-SPOSite -Identity -StorageQuota to increase the library storage limit if the Pending state is caused by quota exhaustion.