OneDrive for Business shared library sync stays pending for new employees: Fix Guide

When a new employee adds a shared library in OneDrive for Business, the sync status often stays on “Pending” for hours or days. This prevents the user from accessing files offline and can block critical onboarding workflows. The root cause is usually a combination of SharePoint site provisioning delays, OneDrive sync throttling for new accounts, and missing library permissions. This guide explains why the pending state occurs and provides a systematic fix to get shared libraries syncing immediately.

Why Shared Library Sync Stays Pending for New Employees

When a new employee adds a shared library in OneDrive for Business, the sync app must first provision the SharePoint site to the user’s OneDrive profile. This provisioning includes creating a hidden sync relationship in the user’s Microsoft 365 tenant, verifying permissions against Azure Active Directory, and downloading the file metadata index. For a new account that has never accessed the SharePoint site, this process can take 15 minutes to 2 hours due to background replication delays.

A second cause is the OneDrive sync throttling algorithm. Microsoft applies a rate limit to new users to prevent rapid library additions from overwhelming the sync service. If the employee adds multiple shared libraries in quick succession, the sync app queues them with a “Pending” status. The queue processes one library at a time, which can leave some libraries stuck in pending for extended periods.

A third cause is permission propagation. When an IT admin adds a new employee to a Microsoft 365 group or SharePoint site, the permission change must replicate across all SharePoint front-end servers and the OneDrive sync backend. If the sync app checks permissions before replication completes, it sees the user as unauthorized and holds the sync at pending. The app does not automatically retry the permission check for 30 minutes in most cases.

Steps to Fix Pending Shared Library Sync for New Employees

1. Verify the user has access to the SharePoint site
   Open a browser and sign in to the Microsoft 365 admin center as a SharePoint admin. Go to Active sites, select the site that contains the shared library. Click Settings > Site permissions > Check permissions. Enter the new employee’s email address and click Check now. The result must show Full Control, Edit, Contribute, or Read access. If the result shows No access, add the user to the site with at least Read permission and wait 10 minutes for replication.
2. Unlink and relink OneDrive on the employee’s computer
   On the new employee’s Windows 10 or 11 device, right-click the OneDrive cloud icon in the notification area. Select Settings > Account > Unlink this PC. Click Unlink account to confirm. Wait 30 seconds, then sign in again with the employee’s Microsoft 365 work account. This forces OneDrive to re-provision all shared libraries from scratch, bypassing any stuck provisioning state.
3. Manually trigger a sync cycle for the stuck library
   In File Explorer, open the OneDrive folder. Right-click the shared library folder that shows the pending sync icon. Select Free up space if the option appears, then select Sync. If Free up space does not appear, right-click the OneDrive cloud icon, choose Pause sync > 2 hours. Wait 10 seconds, then right-click again and choose Resume sync. This forces the sync app to re-evaluate the library queue.
4. Clear the OneDrive sync queue from the registry
   Close OneDrive completely by right-clicking the cloud icon and selecting Quit OneDrive. Press Windows key + R, type regedit, and press Enter. Navigate to HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. In the right pane, locate the value named LibraryProvisioningQueue. Right-click it and select Delete. Close Registry Editor and restart OneDrive from the Start menu. This clears any stuck provisioning requests.
5. Reset OneDrive sync app settings if the issue persists
   Press Windows key + R, type %localappdata%\Microsoft\OneDrive\settings\Business1, and press Enter. Delete all files in this folder. Then press Windows key + R again, type %localappdata%\Microsoft\OneDrive\OneDrive.exe /reset, and press Enter. Wait for OneDrive to restart automatically. Add the shared library again by clicking the OneDrive cloud icon > Add shortcut > the shared library name.

If OneDrive Still Shows Pending After the Main Fix

The library appears in the web browser but not in OneDrive sync

This indicates the library was added to OneDrive sync before site provisioning completed. Go to the SharePoint site in a browser. Click the Documents tab. In the command bar, click Sync. If the button says Sync is already set up, click the three dots next to it and select Remove sync. Then click Sync again to re-add the library. This sends a fresh provisioning request directly from SharePoint to the OneDrive sync app.

OneDrive shows “You don’t have access to this library”

Permission replication can take up to 24 hours for nested groups. If the employee is a member of a Microsoft 365 group that has access to the library, check whether the group membership has propagated. In the Azure AD admin center, go to Users > the employee’s account > Groups. Verify the group appears. If it does not, add the employee directly to the SharePoint site with Contribute permissions as a temporary workaround.

The pending status only occurs on the employee’s personal device

The employee may have signed in to OneDrive with a personal Microsoft account before using their work account. This creates a conflicting cache. Go to Control Panel > Credential Manager > Windows Credentials. Scroll to Generic Credentials and remove any entries that contain OneDrive Cached Credential. Then repeat the unlink and relink steps from the main fix.

OneDrive Sync Methods for New Employees: At-a-Glance Comparison

Item	Sync from SharePoint in Browser	Sync from OneDrive App
Description	Click Sync button on SharePoint Documents page	Use Add shortcut in OneDrive settings or File Explorer
Provisioning trigger	Direct SharePoint-to-OneDrive request bypasses queue	Queued through OneDrive backend with throttling
Best for new employees	Yes, forces immediate provisioning	No, can get stuck in pending for hours
Requires browser sign-in	Yes	No
Recovery from pending	Rarely needed	Often requires unlinking or registry edit

For new employees, always use the Sync button on the SharePoint Documents page in a browser. This method bypasses the OneDrive sync queue and throttling algorithm. Use the OneDrive app method only after the initial provisioning completes successfully.

You can now resolve a pending shared library sync for any new employee within 10 minutes by unlinking the account, verifying permissions, and using the browser-based Sync method. Next, configure Known Folder Move for the employee to ensure Desktop, Documents, and Pictures sync automatically. For ongoing management, set up a SharePoint site provisioning policy in the Microsoft 365 admin center that pre-provisiones sync relationships for new users before their first sign-in.