OneDrive for Business shared library sync troubleshooting for remote workers: stays pending

Remote workers often see a shared library in OneDrive stuck on Pending sync status. This means files are not downloading or updating even with a stable internet connection. The cause is usually a combination of network restrictions, authentication token expiry, or sync client throttling when many users access the same library. This article explains why the Pending state occurs and provides step-by-step fixes to restore sync for shared libraries.

Why OneDrive Shared Library Sync Shows Pending

OneDrive uses a real-time sync engine that communicates with SharePoint Online via HTTPS. When a shared library stays Pending, the sync client has detected a change but cannot complete the transfer. Three root causes are common for remote workers.

Network Proxy or VPN Interference

Corporate VPNs often route SharePoint traffic through a slow gateway. Proxy servers may block the WebSocket connection that OneDrive uses for instant notifications. Without WebSocket, the client falls back to polling every 30 minutes, showing Pending between checks.

Expired or Revoked Authentication Tokens

OneDrive caches OAuth tokens in Windows Credential Manager. If your password changed or multi-factor authentication session expired, the token becomes invalid. The client cannot refresh automatically and marks the library as Pending.

Sync Throttling by SharePoint Online

SharePoint Online applies rate limits when a single user syncs more than 20,000 items or when many users sync the same library simultaneously. Remote teams often trigger throttling during large file migrations or daily collaboration peaks. The server returns a 429 response, and OneDrive shows Pending until the cooldown ends.

Steps to Fix OneDrive Shared Library Sync Pending

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

1. Check OneDrive sync status icon
   Right-click the OneDrive cloud icon in the system tray near the clock. Select View sync problems. If the shared library shows Pending with a specific error code, note the code for later troubleshooting.
2. Pause and resume sync
   Right-click the OneDrive cloud icon and select Pause syncing > 2 hours. After two hours, right-click again and select Resume syncing. This forces a fresh sync cycle without unlinking the library.
3. Clear cached credentials in Credential Manager
   Open Control Panel > User Accounts > Credential Manager > Windows Credentials. Scroll to Generic Credentials. Look for entries containing OneDrive Cached Credential or MicrosoftOffice16. Click the arrow to expand each entry, then Remove. Restart OneDrive. The client will prompt you to sign in again.
4. Unlink and relink the PC from OneDrive
   Right-click the OneDrive cloud icon and select Settings. Go to the Account tab. Click Unlink this PC. Confirm the action. After unlinking, sign in again with your work account. OneDrive will re-sync all libraries, including the shared one. Local files remain untouched.
5. Disable proxy or VPN temporarily
   If you use a corporate VPN, disconnect from the VPN. Open Windows Settings > Network & Internet > Proxy. Turn off Use a proxy server. Test sync. If sync completes, the VPN or proxy is the cause. Add SharePoint domains to the VPN bypass list or configure the proxy to allow WebSocket traffic.
6. Reset OneDrive app
   Press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. Wait 60 seconds. OneDrive re-launches automatically. If it does not, press Windows key + R again and type %localappdata%\Microsoft\OneDrive\onedrive.exe. Sign in again.
7. Reduce the number of syncing items
   Open OneDrive settings > Sync and backup > Manage backup. Turn off backup for folders you do not need on this device. For the shared library, right-click it in File Explorer, select OneDrive > Choose folders, and uncheck subfolders you do not need. Fewer items reduce the chance of throttling.

If OneDrive Still Shows Pending After the Main Fix

OneDrive Shows Pending Only for One Specific Library

Other libraries sync fine. This points to a library-level issue. Ask the SharePoint site owner to check the library settings. Go to the library in a browser, click the gear icon > Library settings > Permissions for this document library. Ensure you have at least Contribute permission. If the library has unique permissions, the sync token may be stale. The site owner can create a new library and move files there.

OneDrive Shows Pending After Password Change

Your organization forced a password reset. OneDrive cached the old token. Open Credential Manager as described in step 3 above. Remove all entries with OneDrive or MicrosoftOffice in the name. Restart OneDrive and sign in with the new password.

OneDrive Shows Pending on a Company-Managed Device

Group Policy may block sync for shared libraries. Contact your IT administrator. Ask them to check the policy setting: Computer Configuration > Administrative Templates > OneDrive > Prevent users from syncing personal OneDrive accounts. This policy should be Not Configured or Disabled for shared libraries to sync. Also verify that the SharePoint URL is not in the blocked list under Computer Configuration > Administrative Templates > OneDrive > Exclude specific SharePoint sites from synchronization.

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

Item	Files On-Demand	Always Keep on This Device
Description	Files appear online-only until opened; syncs metadata only	Downloads full file content to local disk; uses more space
Effect on Pending status	Can reduce Pending time because the client syncs fewer bytes per file	May increase Pending duration if many large files are being downloaded
Best for remote workers	Recommended for users with limited bandwidth or high latency	Use only for files needed offline; avoid for entire libraries
How to set	Right-click OneDrive icon > Settings > Sync and backup > Advanced settings > Files On-Demand > turn on	Right-click a file or folder in File Explorer > Always keep on this device

Remote workers should enable Files On-Demand globally and only mark specific files as Always keep on this device. This reduces the number of bytes that must transfer during each sync cycle, lowering the chance of hitting SharePoint throttling limits.

You can now diagnose and fix a shared library stuck on Pending by clearing credentials, unlinking the PC, or adjusting VPN settings. Next, check the OneDrive Activity Center daily to catch Pending states early. For persistent throttling, ask your SharePoint admin to increase the library item limit from 5,000 to 20,000 in the site collection settings.