OneDrive for Business shared library sync troubleshooting for hybrid teams: stays pending

When you sync a shared library in OneDrive for Business, the sync status may stay on “Processing changes” or show a pending state for hours. This problem affects hybrid teams where some members work on-premises and others in the cloud. The root cause is often a mismatch between local file versions and server-side metadata, combined with OneDrive’s throttling behavior for large shared libraries. This article explains why the pending state occurs and provides a step-by-step method to force the sync to complete.

Why the Shared Library Sync Stays Pending for Hybrid Teams

OneDrive for Business shared libraries are backed by SharePoint Online. When a user syncs a library, the OneDrive sync engine compares local file metadata with the SharePoint server metadata. For hybrid teams, the metadata includes version history, co-authoring locks, and file property changes that occur both on-premises and in the cloud.

The pending state occurs when OneDrive cannot resolve conflicts between the local cache and the server. This commonly happens when:

• The library has more than 5,000 items. SharePoint throttles requests for libraries above this threshold, causing OneDrive to pause sync.
• Version history limits are high. Each version stores metadata that OneDrive must process. Libraries with 500 versions per file create a heavy sync load.
• File locks from co-authoring are not released cleanly. If a hybrid team member edits a file on a local server and the same file is edited in SharePoint Online, the lock state can become ambiguous.
• OneDrive is configured with the default throttling behavior. The sync engine reduces its polling rate when it detects high churn, which makes the pending state last longer.

The sync engine uses a file called the sync database to track changes. When the database grows large due to many pending changes, the sync process enters a loop of re-evaluating metadata without completing the sync. This is why the status shows “Processing changes” indefinitely.

Steps to Force the Shared Library Sync to Complete

These steps resolve the pending state without deleting your local files or breaking the sync relationship. Perform them in the order shown.

1. Stop the OneDrive sync process
   Right-click the OneDrive cloud icon in the system tray. Select Pause syncing and choose 2 hours. Wait 30 seconds. This stops the sync engine from processing new changes while you prepare the fix.
2. Unsync the shared library
   Open OneDrive settings by clicking the OneDrive icon in the system tray, then selecting the gear icon and Settings. Go to the Account tab. Under Manage the folders synced on this computer, find the shared library that is stuck. Click Stop sync. Confirm the prompt. This removes the sync relationship but does not delete the local copy of the files.
3. Close OneDrive completely
   Right-click the OneDrive icon in the system tray and select Exit. Open Task Manager by pressing Ctrl + Shift + Escape. In the Processes tab, look for any remaining OneDrive.exe processes. Select each one and click End task. Wait 10 seconds.
4. Clear the OneDrive sync cache
   Press Win + R, type %localappdata%\Microsoft\OneDrive\settings\Business1, and press Enter. Delete all files in this folder. Do not delete the folder itself. This removes the cached metadata that causes the pending loop. The files will be re-synced from SharePoint.
5. Restart OneDrive and re-sync the library
   Open the Start menu, type OneDrive, and press Enter. Sign in if prompted. After OneDrive starts, click the OneDrive icon in the system tray, select the gear icon, and choose Settings. Go to the Account tab. Click Add an account or Choose folders. Navigate to the shared library and check the box next to it. Click Start sync. OneDrive will rebuild the sync database and begin syncing.
6. Monitor the sync status
   Hover over the OneDrive icon in the system tray. The status should change from Processing changes to Up to date within 15 minutes for libraries under 5,000 items. For larger libraries, allow up to 2 hours. If the pending status returns, repeat steps 1 through 3 and then proceed to the next section.

If OneDrive Still Shows Pending After the Main Fix

OneDrive sync is stuck on “Processing changes” after re-adding the library

This indicates that the sync cache rebuild is failing due to a corrupted local file. Open the synced folder in File Explorer. Look for files with a red X overlay. Rename or delete those files. Then restart OneDrive using the steps above. The sync engine will download fresh copies from SharePoint.

The shared library has more than 20,000 items

SharePoint Online has a sync limit of 20,000 items per library. If the library exceeds this count, OneDrive will not sync the entire library. Ask the site owner to split the library into multiple libraries with fewer items. Alternatively, use the Add shortcut to OneDrive feature instead of sync. This creates a web link that opens the library in a browser without syncing files locally.

Hybrid team members see different file versions after sync

This is caused by version conflicts between on-premises and cloud copies. Instruct all team members to use the same sync method. If some users sync via OneDrive and others access files through a mapped drive to a local server, version mismatches are inevitable. Move all files to SharePoint Online and remove the on-premises mapped drives. Then perform the main fix steps above on each machine.

OneDrive shows “Pending” for a library that was previously working

A recent update to OneDrive may have changed the sync behavior. Check the OneDrive version by right-clicking the OneDrive icon in the system tray, selecting Settings, then going to the About tab. If the version is older than 24.001.0129.0001, download the latest version from the Microsoft 365 admin center. After updating, repeat the main fix steps.

Sync Methods for Shared Libraries: OneDrive vs SharePoint Sync Button vs Add Shortcut

Item	OneDrive Sync Client	SharePoint Sync Button	Add Shortcut to OneDrive
How it works	Downloads files to the local OneDrive folder and syncs changes bidirectionally	Opens the library in File Explorer via a web-based sync initiated from SharePoint	Creates a web shortcut in the OneDrive folder that opens the library in a browser
Offline access	Full offline access to all synced files	Full offline access only if files are marked as “Always keep on this device”	No offline access. Files open in the browser
Best for	Users who need offline access and work with fewer than 20,000 items	Users who need offline access for specific files in large libraries	Users who rarely need offline access and want to avoid sync overhead
Sync pending issues	Most common. Caused by metadata conflicts, large item counts, or version history	Less common because the sync is triggered on demand from SharePoint	No sync pending issues because no files are downloaded

Now you can force a stuck shared library sync to complete by clearing the sync cache and re-adding the library. Next, review the version history settings in your SharePoint library. Set the version limit to 100 to prevent future pending states. For hybrid teams, ensure all members use the OneDrive sync client exclusively rather than mixing on-premises mapped drives.