OneDrive Admin Checklist: shared library sync stays pending for hybrid teams

Hybrid teams often report that shared library sync in OneDrive stays in a pending state. Files appear with a blue cloud icon that never changes to a green checkmark. This usually happens because of network latency, incorrect sync permissions, or group policy restrictions. This article lists the root causes in order of likelihood and provides a step-by-step checklist for administrators to resolve the issue.

Why Shared Library Sync Stays Pending for Remote and Office Users

When a hybrid team member syncs a shared library, OneDrive must communicate with both the local file system and the SharePoint Online server. A pending state means the sync engine has detected changes but cannot complete the transfer. The most common technical root cause is a conflict between the user’s local proxy or VPN and the SharePoint endpoint. If the device uses a split-tunnel VPN, traffic to sharepoint.com and all subdomains may route through the corporate network, causing timeouts. Another frequent cause is the SharePoint list view threshold. If the library contains more than 5000 items in a single view, the sync engine cannot enumerate the folder structure and stays pending. Finally, the OneDrive sync app may be blocked by a group policy that restricts syncing only to specific site collections.

Administrator Checklist to Resolve Pending Sync

Follow the steps in the order below. Each step addresses a distinct cause. Do not skip steps unless you are certain the cause is not present.

1. Verify the user’s device sync status in the OneDrive admin center
   Sign in to the Microsoft 365 admin center at admin.microsoft.com. Go to Health > OneDrive admin center > Sync > Manage device sync status. Locate the user’s device. If the status shows “Blocked,” click the device and select “Allow.” If the status shows “Error,” note the error code and follow the remediation link provided.
2. Check the SharePoint list view threshold
   Go to the affected SharePoint site. Navigate to Site contents > Library settings > List view threshold. If the library has more than 5000 items, create indexed columns or add filters to reduce the default view to fewer than 5000 items. Alternatively, increase the threshold in the SharePoint admin center under Settings > List and library experience > List view threshold to a maximum of 5000.
3. Review group policy for sync restrictions
   On a domain-joined device, open the Local Group Policy Editor. Navigate to Computer Configuration > Administrative Templates > OneDrive > Prevent users from syncing specific SharePoint sites. Ensure the affected library’s URL is not listed. If the policy is set to “Block syncing for all sites,” create an exception using the “Allow syncing for specific SharePoint sites” policy.
4. Test network connectivity to SharePoint endpoints
   On the user’s device, open a command prompt as administrator. Run nslookup admin.onedrive.com and nslookup yourtenant.sharepoint.com. Both should resolve to Microsoft IP addresses. If they do not, check the local DNS server or hosts file. Then run Test-NetConnection yourtenant.sharepoint.com -Port 443 in PowerShell. If the connection fails, the VPN or proxy is blocking traffic. Ask the network team to add sharepoint.com and all subdomains to the allow list.
5. Reset the OneDrive sync connection for the shared library
   On the user’s device, right-click the OneDrive icon in the system tray and select Settings > Account. Under “Shared libraries,” find the affected library. Click “Stop sync.” Wait 30 seconds. Then click “Sync” next to the same library. This forces OneDrive to re-authenticate and re-enumerate the library structure.
6. Clear the OneDrive sync cache
   If the previous steps do not resolve the issue, stop OneDrive by right-clicking the system tray icon and selecting Exit. Press Windows key + R, type %localappdata%\Microsoft\OneDrive\settings\Business1, and press Enter. Delete all files in that folder. Restart OneDrive from the Start menu. Sign in again. This clears stale sync metadata that can cause a pending state.

If Shared Library Sync Still Shows Pending After the Checklist

OneDrive Shows “Sync Pending” Only for One User

If only one user in the hybrid team sees the pending state, the cause is likely a corrupt local credential cache. Have the user sign out of OneDrive by right-clicking the system tray icon and selecting Settings > Account > Sign out. Then sign in again. If the problem persists, reset the user’s Microsoft 365 license by going to the Microsoft 365 admin center > Users > Active users, selecting the user, and toggling the OneDrive license off and back on after 5 minutes.

OneDrive Sync Pending for All Users on the Same Library

When every team member sees the pending state for the same shared library, the issue is on the server side. Check the SharePoint site for a locked file or a library that is being migrated. Go to SharePoint admin center > Sites > Active sites. Select the site and click Settings > Site collection administration > Site collection lock. If the lock is set to “No access,” change it to “Unlock.” Also verify that the site is not in “Read-only” mode due to storage quota exhaustion. Increase the storage quota under Settings > Storage limit.

OneDrive Sync Pending After Windows Update

A Windows update can change the OneDrive sync engine version or reset network settings. On the user’s device, open Settings > Windows Update > Update history. Look for a recent update labeled “OneDrive sync engine update.” If present, roll back the update by clicking Uninstall updates and selecting that update. Then reinstall the latest OneDrive sync app from onedrive.com/download.

OneDrive Sync Modes for Shared Libraries: Comparison

Item	Files On-Demand (Default)	Always Keep on This Device
Description	Files appear as placeholders and download only when opened	All files in the selected folder are downloaded and kept in sync
Best for	Hybrid teams with limited local storage or slow VPN connections	Users who need offline access to the entire library
Sync initiation	Triggered by opening a file or using “Sync” in the library	Started manually by right-clicking a folder and selecting “Always keep on this device”
Pending state risk	Low if network is stable; high if library has more than 5000 items	High during initial download; low after all files are cached

Use Files On-Demand for most hybrid team members. Switch to “Always keep on this device” only for users who work offline for extended periods. The pending state is more likely with Always Keep because the sync engine must download every file before the green checkmark appears.

Now you can systematically diagnose and fix the pending sync state for shared libraries in hybrid teams. Start with the device sync status in the admin center and work through the checklist. If the problem persists, check the SharePoint list view threshold and network connectivity. For advanced troubleshooting, enable OneDrive sync logging by running %localappdata%\Microsoft\OneDrive\OneDrive.exe /debuglog from a command prompt. The log file will show the exact HTTP response code that is causing the pending state.