OneDrive Admin Checklist: shared library sync stays pending for new employees

When a new employee adds a shared library in OneDrive, the sync status often stays on Pending for hours or even days. The user sees a spinning blue circle and no files download. This happens because SharePoint Online must provision the user’s permissions and the OneDrive sync engine must run a full discovery pass before content can transfer. This article walks through the exact admin checks and fixes to resolve pending sync for shared libraries on new employee devices.

Why Shared Library Sync Stays Pending for New Employees

The OneDrive sync engine uses a background service called the Office Sync Maintenance task to check for new or changed permissions. When a new employee is added to a site, SharePoint Online does not immediately push that change to the sync client. Instead, the sync engine polls for updates on a schedule that can be as long as every 24 hours.

Another common cause is permission propagation delay. When an admin adds a user to a Microsoft 365 group or SharePoint site, the permission change must replicate across all front-end and back-end servers. During that window, the sync engine sees the library but cannot authenticate the user, so it stays in a Pending state.

A third cause is the OneDrive sync cache. The client stores a local database of file metadata. If the database becomes corrupted or contains stale permission entries, the sync engine cannot start downloading files. This is more common when a new employee signs into a shared or repurposed device.

Admin Checklist to Fix Pending Sync on New Employee Devices

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

1. Verify the user has direct permissions to the SharePoint site
   Open the SharePoint admin center. Go to Active sites and select the site containing the library. Click Settings > Site permissions > Check permissions. Enter the new employee email. If the result shows No permissions, add the user directly to the site Members group or to the Microsoft 365 group that owns the site. Wait 15 minutes for propagation.
2. Confirm the library is not blocked by admin policy
   In the Microsoft 365 admin center, go to Settings > Org settings > OneDrive. Under Sync, check that Sync for SharePoint sites is set to Allow. Also verify that the file type blocking list does not include the file types in the library. If blocked, remove the extensions and click Save.
3. Run the Office Sync Maintenance task manually
   On the new employee device, open Windows Task Scheduler. Navigate to Task Scheduler Library > Microsoft > Office. Right-click the task named Office Sync Maintenance and select Run. This forces the sync engine to re-poll all libraries immediately. Wait 5 minutes and check OneDrive sync status.
4. Unlink and relink the user account in OneDrive
   Right-click the OneDrive cloud icon in the system tray. Select Settings > Account > Unlink this PC. Click Unlink account. After unlinking, sign back in with the same work or school account. This clears stale authentication tokens and forces a fresh permission check.
5. Clear the OneDrive sync cache
   If sync is still pending, stop OneDrive by right-clicking the cloud icon and selecting Quit OneDrive. Open File Explorer and navigate to %localappdata%\Microsoft\OneDrive\settings\Business1. Delete all files and folders inside the Business1 folder. Restart OneDrive from the Start menu. This rebuilds the local sync database.
6. Reset the OneDrive app
   Press Windows key + R, type onedrive.exe /reset, and press Enter. Wait for the reset to complete. OneDrive will relaunch automatically and re-run the initial sync setup. The user will need to sign in again and re-add the shared library.

If OneDrive Sync Still Shows Pending After the Main Fix

OneDrive shows Pending only on one specific library but other libraries sync fine

This usually means the library has a unique permission inheritance break. Open the library in a browser. Go to Library settings > Permissions for this document library. Click Stop Inheriting Permissions if inheritance is broken. Then add the new employee directly with at least Read access. Wait 30 minutes and re-add the library in OneDrive.

New employee sees Pending on all shared libraries

Check whether the user account is licensed for SharePoint Online. Go to Microsoft 365 admin center > Users > Active users, select the user, and click the Licenses and apps tab. Ensure SharePoint Online is toggled On. If the license is correct, check if the user has exceeded the SharePoint storage quota. Go to SharePoint admin center > Active sites, select the site, and look at Storage limit. If the site is full, increase the limit or ask the user to sync only a subset of folders.

OneDrive sync engine does not start at all on the new device

The Office Sync Maintenance task may be disabled. Open Task Scheduler again. Right-click Office Sync Maintenance and select Properties. On the Triggers tab, confirm at least one trigger exists. On the Conditions tab, uncheck Start the task only if the computer is on AC power. Click OK. Then right-click the task and select Run.

Item	Direct Permission Assignment	Group-Based Permission Assignment
Description	User added directly to SharePoint site Members group	User added to Microsoft 365 group that owns the site
Propagation time	5 to 15 minutes	Up to 24 hours in some tenants
Sync engine detection	Immediate on next sync poll	Delayed until group membership sync completes
Best for new employees	Yes — faster resolution	No — can cause pending state

The fastest way to resolve pending sync for a new employee is to assign direct site permissions instead of relying on group membership. After the user has synced successfully, the admin can move the user to the group and remove the direct permission without breaking the sync relationship.

After completing the checklist, the new employee should see files downloading within 10 minutes. If sync still shows Pending, run the Office Sync Maintenance task again and confirm the user can open the library in a web browser. Use the Unlink and Relink method as the final step before escalating to Microsoft Support.