OneDrive for Business shared library sync stays pending for remote workers: Fix Guide

Remote workers often see a shared library stuck on “Pending” in OneDrive sync status. This means files are not downloading or updating. The issue usually comes from network latency, proxy settings, or OneDrive configuration limits on shared libraries. This guide explains the root causes and provides step-by-step fixes to get shared libraries syncing again for remote users.

Why OneDrive Shared Libraries Get Stuck on Pending for Remote Workers

When a remote worker syncs a shared library, OneDrive must maintain a persistent connection to Microsoft 365 servers. The sync engine uses a delta protocol that tracks file changes. If the connection drops or becomes too slow, the sync state changes to “Pending” and does not recover automatically.

Common technical causes include:

Network Latency and Packet Loss

Remote workers often use VPNs or home internet connections with high latency above 100 ms. OneDrive’s sync engine expects a stable TCP connection. Packet loss of just 2 percent can cause the sync to pause indefinitely.

Proxy or Firewall Interference

Corporate proxies may cache or block the specific URLs that OneDrive uses for shared libraries. The sync app cannot negotiate the connection and falls back to “Pending” status.

OneDrive Shared Library Limit

OneDrive for Business has a limit of syncing 25 shared libraries per user. If a remote worker has more than 25 libraries added, the 26th will stay pending indefinitely. The limit applies to libraries owned by other users, not the user’s own OneDrive.

Steps to Fix a Pending Shared Library Sync for Remote Workers

Follow these steps in order. Test sync status after each step before moving to the next.

1. Stop and re-add the shared library
   Open OneDrive sync app settings. Go to the Account tab. Find the stuck shared library. Click Stop sync. Confirm the action. Then click Add a library and browse to the same shared library. This forces a fresh sync token negotiation.
2. Disable proxy settings temporarily
   Open Windows Settings. Go to Network and Internet. Select Proxy. Turn off Use a proxy server. If you cannot disable it permanently, add these URLs to the proxy exclusion list: sharepoint.com, onedrive.com, and all subdomains. Apply changes and restart OneDrive.
3. Increase the download rate limit
   In OneDrive settings, go to the Network tab. Under Download rate limit, select Don’t limit. If you must limit, set it to at least 10 Mbps. Remote workers on VPN often see default limits that are too low.
4. Check the shared library count
   In OneDrive Account settings, count the number of shared libraries listed. If there are more than 25, remove libraries you do not need. Use Stop sync on the oldest or least-used libraries first.
5. Run the OneDrive sync troubleshooter
   Press Windows key + R, type onedrive.exe /reset, and press Enter. Wait 60 seconds. Then open OneDrive again. This resets the sync database without deleting local files.
6. Disable IPv6 on the network adapter
   Open Control Panel. Go to Network and Sharing Center. Select Change adapter settings. Right-click your active network adapter and select Properties. Uncheck Internet Protocol Version 6 (TCP/IPv6). Click OK. Restart the computer. Some VPN configurations cause IPv6 negotiation failures that stall sync.

If OneDrive Still Has Issues After the Main Fix

If the shared library remains pending after following all steps above, check these additional scenarios.

OneDrive shows “Pending” on all libraries but not on personal files

This indicates a permissions or licensing issue. Verify the remote worker has an active Microsoft 365 license that includes OneDrive. Also confirm they have at least Read access to the shared library. The library owner must share the library with the remote user’s work email address.

Sync works on the corporate network but fails remotely

The issue is almost certainly the VPN or proxy. Ask the remote worker to disconnect from VPN and sync directly over their home internet. If sync starts immediately, the VPN is filtering or shaping traffic. Work with your network team to whitelist OneDrive and SharePoint URLs on the VPN.

OneDrive sync app crashes or freezes when accessing shared libraries

This can happen if the shared library contains files with unsupported characters or very long paths. Run the OneDrive diagnostic tool by pressing Windows key + R, typing onedrive.exe /diagnose, and pressing Enter. Review the log for file path errors. Ask the library owner to rename files that exceed 400 characters or contain characters like # % &.

Files-On-Demand vs Always Keep on This Device for Shared Libraries

Item	Files On-Demand	Always Keep on This Device
Description	Files appear as online-only placeholders until opened	Files are downloaded fully and always available offline
Disk space usage	Minimal – only metadata stored locally	High – full file content stored locally
Sync stability for remote workers	Better – fewer sync operations over slow links	Worse – constant download attempts can trigger pending state
Recommended for remote workers	Yes – default setting after OneDrive setup	Only for a few critical files, not entire libraries

Remote workers should keep Files On-Demand enabled for all shared libraries. To verify, right-click the shared library folder in File Explorer, select OneDrive, and check that Always keep on this device is not checked. If it is checked, uncheck it and let the files revert to online-only.

You can now fix a pending shared library sync by stopping and re-adding the library, adjusting proxy and network settings, and verifying the library count is under 25. Next, ask remote workers to test sync over a direct internet connection without VPN to isolate the root cause. As an advanced tip, use the OneDrive deployment tool to preconfigure the 25-library limit warning in Group Policy so users do not exceed it unknowingly.