OneDrive Admin Checklist: shared library sync stays pending for remote workers

Remote workers often report that a shared library in OneDrive shows a sync status of Pending for hours or days. This symptom prevents team members from accessing updated files and blocks offline availability. The root cause is typically a combination of network latency, throttling by the SharePoint Online service, or restrictive tenant sync policies applied to external or remote connections. This article provides a structured admin checklist to diagnose and resolve pending sync on shared libraries for remote workers.

Why Shared Library Sync Gets Stuck on Pending for Remote Workers

When a remote worker adds a shared library to their OneDrive sync app, the app sends a request to SharePoint Online to enumerate the library contents and download metadata. The SharePoint Online service applies per-user throttling limits to prevent excessive API calls. Remote workers connecting over a VPN or a high-latency WAN link often exceed these limits because of repeated retries caused by packet loss or slow responses. The sync app then backs off and shows Pending.

Another common cause is the OneDrive sync app’s download throughput limit. If an admin has enabled a global download cap via Group Policy or the OneDrive admin center, the sync app may queue the entire library download and show pending until bandwidth becomes available. Additionally, tenant sync policies that block sync for specific site collections or file extensions can trigger a pending state without an explicit error message.

SharePoint Online Throttling Behavior

SharePoint Online limits the number of API requests per app per user within a rolling 5-minute window. When the sync app hits this limit, it receives HTTP 429 responses and pauses all sync activity for that library. The pause duration can be up to 30 minutes, during which the sync status shows Pending. Remote workers with unstable connections are more likely to trigger this throttling because each dropped connection results in a new request attempt.

VPN and Proxy Interference

VPNs and corporate proxies can interfere with the sync app’s ability to maintain a persistent WebSocket connection to SharePoint Online. When the connection drops, the app falls back to polling, which increases the request rate. After several failed polling attempts, the app enters a pending state. Some VPN configurations also block the TCP ports used by the sync app for file transfer.

Admin Checklist to Resolve Shared Library Pending Sync

Use the following steps in order. Each step addresses a specific cause. Verify the result after each step before moving to the next.

1. Check tenant sync settings in the Microsoft 365 admin center
   Sign in to the Microsoft 365 admin center. Go to Settings > Org settings > OneDrive > Sync. Ensure Allow syncing only on computers joined to specific domains is not enabled unless all remote computers are domain-joined. If it is enabled, disable it or add the remote worker’s device domain. Also verify that Block sync of specific file types does not include file types present in the shared library.
2. Review SharePoint sharing and permissions for the shared library
   In the SharePoint admin center, go to Active sites and select the site containing the library. Click Settings > Sharing. Confirm that sharing is set to Anyone or New and existing guests if the remote worker is external. If the worker is internal but connecting from an unmanaged device, ensure Allow editing is enabled for the library permission level.
3. Verify the user’s OneDrive sync app version
   Ask the remote worker to open OneDrive settings by clicking the OneDrive cloud icon in the system tray and selecting Help & Settings > Settings > About. The version must be 23.001 or later. If the version is older, instruct the worker to download the latest sync app from portal.office.com > OneDrive > Sync.
4. Disable the download throughput limit for the user
   In the Microsoft 365 admin center, go to Settings > Org settings > OneDrive > Sync. Under Download throughput limit, select No limit or set a higher limit for the remote worker’s group. Alternatively, use the OneDrive Group Policy template to remove the Set download throughput limit policy for the affected user.
5. Exclude the shared library from any file type blocking policy
   In the Microsoft 365 admin center, go to Settings > Org settings > OneDrive > Sync. Under Block sync of specific file types, remove any file extensions that are in the library. If you cannot remove them, ask the user to remove those files from the library or change their file types.
6. Clear the OneDrive sync app cache on the remote worker’s computer
   Instruct the remote worker to quit OneDrive by right-clicking the cloud icon and selecting Quit OneDrive. Then press Win + R, type %localappdata%\Microsoft\OneDrive\settings\Business1, and delete all files in that folder. Restart OneDrive from the Start menu. This resets the app’s internal state for shared libraries.
7. Test sync without VPN
   Ask the remote worker to disconnect from the corporate VPN temporarily and sync the library over the direct internet connection. If the pending status clears, the VPN is interfering. The worker should contact their network team to allow the OneDrive sync app’s endpoints: sharepoint.com and all subdomains, onedrive.com and all subdomains, and files.1drv.com and all subdomains over TCP port 443.
8. Reset the shared library sync relationship
   If all previous steps fail, remove the library from OneDrive sync and re-add it. On the remote worker’s computer, open OneDrive settings, go to Account > Choose folders, and uncheck the shared library. Click OK. Wait 5 minutes. Then go to the library in the web browser, click Sync, and follow the prompts to re-add it.

If the Shared Library Still Shows Pending After the Checklist

OneDrive sync app reports pending on multiple shared libraries

This indicates a tenant-level throttle or a network issue affecting all SharePoint Online traffic. Check the SharePoint Online throttling status in the Microsoft 365 admin center under Health > Service health. If no service incident exists, ask the worker to run the OneDrive sync troubleshooter by pressing Win + R, typing onedrive /reset, and pressing Enter. After the reset, the app will reinitialize and may clear the pending status.

OneDrive shows pending only when the remote worker is on a specific Wi-Fi network

The network likely blocks WebSocket connections. Instruct the worker to test on a different network, such as a mobile hotspot. If pending clears on the hotspot, the corporate Wi-Fi or guest network is blocking the sync protocol. The network team must allow outbound WebSocket connections to sharepoint.com and all subdomains and onedrive.com and all subdomains.

Pending status occurs after a file name change in the shared library

SharePoint Online indexes file names. A rename triggers a re-index, which can cause a brief pending state for all syncing users. This is normal and usually resolves within 15 minutes. If it persists, ask the user to pause sync and resume it by right-clicking the OneDrive cloud icon and selecting Pause syncing > 2 hours, then Resume syncing after 2 minutes.

Sync Pending vs Sync Error: What Admins Need to Know

Item	Pending	Error
Icon in system tray	OneDrive cloud icon with a pause symbol	OneDrive cloud icon with a red X
Status message	Syncing pending	Sync error or Can’t sync
Primary cause	Throttling, network latency, or download queue	Permission denied, file name conflict, or corrupted file
Resolution time	Usually self-resolves within 30 minutes	Requires user or admin action
Admin action needed	Rarely needed; verify throttling limits if frequent	Check permissions, file names, and blocked file types

Understanding the difference helps admins decide whether to intervene or wait. Pending is often a temporary condition that resolves without action. An error requires investigation of the specific file or permission issue.

By completing this checklist, you can systematically eliminate the most common causes of pending shared library sync for remote workers. Start with the tenant sync settings and work through the steps in order. If the problem recurs, check the OneDrive sync app version and the network connectivity of the remote worker. As an advanced tip, use the OneDrive Diagnostic Tool (available in the Microsoft 365 admin center under Health > OneDrive Diagnostic) to collect sync logs from the remote worker’s computer and identify throttling events or blocked endpoints.