OneDrive for Business shared library sync stays pending for slow networks: Fix Guide

When you add a shared library in OneDrive for Business, the sync status may show “Pending” for hours or days on a slow or metered network connection. This happens because OneDrive uses a default network detection algorithm that throttles or pauses sync when it detects limited bandwidth. The pending state prevents you from accessing updated files offline and can disrupt team collaboration. This guide explains why the pending status occurs on slow networks and provides specific configuration changes to force sync to proceed reliably.

Why OneDrive Shared Library Sync Stays Pending on Slow Networks

OneDrive for Business includes a built-in bandwidth management feature that automatically pauses or throttles sync when it detects a slow or unreliable network connection. This feature is designed to prevent OneDrive from consuming all available bandwidth and impacting other applications. However, on consistently slow networks such as DSL, satellite, or cellular hotspots, the detection algorithm may keep sync in a perpetual “Pending” state because it never sees enough throughput to resume normal operation.

The pending status is not a failure but a deliberate pause. OneDrive’s sync engine monitors network speed and latency. When the measured speed falls below a certain threshold, the engine marks the sync as pending and waits for better conditions. For shared libraries, this behavior is more aggressive because those libraries often contain many files and frequent changes, which the engine treats as high-risk for consuming bandwidth.

Additionally, Windows may identify the network as “metered” based on the connection type or user settings. OneDrive respects the metered network flag and pauses sync by default to avoid data overage charges. If your slow network is also marked as metered, OneDrive will keep the shared library sync in a pending state indefinitely until you override this setting.

Steps to Force OneDrive Shared Library Sync on a Slow Network

The following steps disable automatic throttling and metered network restrictions so that OneDrive syncs shared libraries even on slow connections. Perform these steps on each client computer that shows the pending status.

Method 1: Disable Bandwidth Throttling in OneDrive Settings

1. Open OneDrive Settings
   Right-click the OneDrive cloud icon in the system tray near the clock and select Settings. If the icon is not visible, click the up arrow to show hidden icons first.
2. Navigate to the Network tab
   In the Settings window, click the Sync and backup tab, then click Advanced settings. Scroll down to the Network section.
3. Disable automatic bandwidth limits
   Under Bandwidth limits, change the setting from “Let OneDrive set limits automatically” to Don’t limit. This tells OneDrive to use the full available bandwidth without throttling.
4. Turn off metered network pause
   Under Network, uncheck the box labeled Pause sync when on metered networks. This allows OneDrive to sync even when Windows reports the network as metered.
5. Apply and restart sync
   Click OK to save changes. Right-click the OneDrive icon again and select Pause syncing then Resume syncing to force a fresh sync attempt.

Method 2: Set a Manual Download Speed Limit via Registry

If the settings above do not resolve the pending status, you can set a specific download speed limit in the Windows Registry. This prevents OneDrive from stopping sync due to perceived slowness.

1. Open Registry Editor
   Press Windows + R, type regedit, and press Enter. Click Yes if prompted by User Account Control.
2. Navigate to the OneDrive account key
   Go to HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. If you have multiple business accounts, look for Business2, Business3, and so on until you find the correct one.
3. Create or modify the MaxDownloadSpeed value
   Right-click in the right pane, select New > DWORD (32-bit) Value, and name it MaxDownloadSpeed. Double-click the new value, set the base to Decimal, and enter a number representing the maximum download speed in kilobytes per second. For a slow 1 Mbps connection, use 125 (125 KB/s). For 512 Kbps, use 64.
4. Create or modify the MaxUploadSpeed value
   Repeat the step above to create a DWORD named MaxUploadSpeed and set it to the same or a lower number, such as 64.
5. Restart OneDrive
   Close Registry Editor. Right-click the OneDrive icon and select Quit OneDrive. Launch OneDrive again from the Start menu. The shared library sync should now start processing.

Method 3: Disable Windows Metered Network Detection

1. Open Network & Internet settings
   Press Windows + I to open Settings, then click Network & internet.
2. Change connection properties
   Click Properties for the active network connection. Scroll down to Metered connection and set it to Off.
3. Restart OneDrive sync
   Right-click the OneDrive icon and select Resume syncing if it was paused.

If OneDrive Shared Library Sync Still Stays Pending

OneDrive shows “Pending” for only some files in the shared library

When only a subset of files shows pending, the issue is likely file-level throttling. OneDrive prioritizes smaller files over large ones. Large files above 100 MB may remain pending while smaller files sync. To resolve this, pause and resume sync again. If the large files still stay pending, set a higher MaxDownloadSpeed value in the registry, such as 500 for a 4 Mbps connection.

Shared library sync stays pending after a network change

If you switch from a fast to a slow network, OneDrive may not immediately detect the change. Force a network refresh by disconnecting and reconnecting the Wi-Fi or Ethernet. Then right-click the OneDrive icon and select Resume syncing. If the pending status persists, restart OneDrive completely using the Quit option.

OneDrive sync stays pending on a VPN connection

VPN connections often add latency that OneDrive interprets as a slow network. In OneDrive settings, ensure bandwidth limits are set to Don’t limit. If the VPN uses a metered connection flag, disable the “Pause sync when on metered networks” option as described in Method 1. You can also add an exception for OneDrive in the VPN client’s split tunneling settings so that OneDrive traffic bypasses the VPN.

Bandwidth Throttling vs Manual Speed Limits: Key Differences

Item	Automatic Bandwidth Throttling	Manual Speed Limit via Registry
Description	OneDrive dynamically adjusts speed based on network conditions	You set a fixed maximum speed in KB/s that OneDrive never exceeds
Effect on slow networks	May pause sync entirely when speed drops below threshold	Sync continues at the defined speed even on very slow links
Configuration location	OneDrive settings > Sync and backup > Advanced settings > Network	Registry key HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1
User interface	Graphical, easy to toggle	Requires Registry Editor, no GUI
Best use case	Fast or variable networks where throttling is rarely needed	Consistently slow networks where automatic throttling prevents sync

After applying the settings and registry changes described above, your OneDrive for Business shared library should exit the pending state and begin syncing files even on a slow network connection. Next, verify that file changes are appearing in the shared library by editing a test document and checking that the sync icon shows a green checkmark. For ongoing management on slow networks, consider using the Files On-Demand feature to keep only file metadata locally and download files on demand, which reduces the amount of data OneDrive needs to sync at once.