When a new employee adds a shared library in OneDrive for Business, the sync status often stays on Pending indefinitely. The library appears in File Explorer but no files download. This happens because the user account lacks the required permissions or the sync client has not completed the initial authentication handshake with the SharePoint site. This article explains the root cause of the pending state and provides step-by-step fixes to get the library syncing correctly.
Key Takeaways: Fixing a Shared Library That Stays Pending for New Users
- OneDrive Settings > Account > Sync and backup > Manage backup: Verifies that the user’s personal OneDrive is configured before adding shared libraries.
- SharePoint site permissions check: The new employee must have at least Read access to the library’s parent site, not just the library itself.
- OneDrive reset via Run dialog (onedrive.exe /reset): Clears a stuck sync relationship without deleting local files.
Why a Shared Library Stays Pending for a New Employee
When a new employee adds a shared library in OneDrive for Business, the sync client sends an authentication request to the SharePoint site. If the user account has not yet been granted explicit permissions to the site, the request is queued but never completed. The sync status then displays Pending instead of Syncing.
Another common cause is that the user’s personal OneDrive folder has not finished its initial setup. OneDrive for Business requires the personal sync relationship to be active before it can process shared libraries. If the personal OneDrive is still in a provisioning state, the sync client blocks all shared library requests.
A third cause involves the OneDrive sync client version. Older versions of the sync client do not support the modern authentication protocol required by SharePoint Online. New employees who install OneDrive from the Microsoft Store may receive a client that is not fully updated for shared library sync.
Steps to Resolve the Pending Sync State
- Verify the user’s SharePoint site permissions
Open a web browser and navigate to the SharePoint site that hosts the shared library. Select the gear icon in the top right, then choose Site permissions. Under Site sharing, click Invite people. Enter the new employee’s email address and assign at least the Read permission level. The user must be a member of the site, not just the library. After adding the user, ask them to refresh the OneDrive sync status by right-clicking the OneDrive icon in the system tray and selecting View sync problems. - Complete the personal OneDrive setup
On the new employee’s computer, open OneDrive settings by right-clicking the OneDrive cloud icon in the system tray and selecting Settings. Go to the Account tab. If the personal OneDrive shows a status of Not set up, click Add an account and sign in with the user’s work credentials. Wait for the initial sync to finish. This may take several minutes for large personal libraries. Once the personal OneDrive shows Synced, return to the shared library and check its status. - Reset the OneDrive sync client
Press the Windows key and type OneDrive. Right-click the OneDrive desktop app and select Open file location. In the File Explorer window, hold the Shift key and right-click the OneDrive.exe file. Select Copy as path. Press Windows key + R to open the Run dialog. Paste the path and add /reset at the end, then press Enter. For example: C:\Users\username\AppData\Local\Microsoft\OneDrive\OneDrive.exe /reset. A command prompt window opens briefly. After the reset completes, OneDrive restarts automatically. Re-add the shared library by clicking the OneDrive icon, selecting Settings > Account > Add a shared library, and choosing the library from the list. - Update the OneDrive sync client
Right-click the OneDrive icon in the system tray and select Settings. Go to the About tab. Note the build number. Compare it with the latest build listed on the Microsoft 365 admin center or the OneDrive release notes page. If the version is older than 22.222 or higher, download the latest OneDrive sync client from the Microsoft Download Center. Run the installer and follow the prompts. After the update, restart the computer and check the shared library sync status. - Clear the Office credential cache
Open the Windows Control Panel and select Credential Manager. Click Windows Credentials. Scroll to the Generic Credentials section. Look for any entries that contain OneDrive Caches or SharePoint Online. Select each entry and click Remove. After clearing the credentials, restart OneDrive by right-clicking the system tray icon and selecting Quit. Then relaunch OneDrive from the Start menu. The sync client will prompt for sign-in again. Enter the user’s work credentials and check the shared library status.
If OneDrive Still Shows Pending After the Main Fix
OneDrive says Pending but the library has files in File Explorer
This occurs when the sync client has partially downloaded files but cannot complete the metadata sync. Right-click the shared library folder in File Explorer and select Free up space. This forces OneDrive to re-evaluate the sync state. After a few minutes, the status should change to Syncing or Synced.
The shared library does not appear in the Add a shared library list
The user’s account may not have been added to the SharePoint site group. Go back to the SharePoint site permissions page and confirm the user is listed under Site members. If the user is listed but still missing from the OneDrive list, ask them to sign out of OneDrive and sign back in. Right-click the OneDrive icon, select Settings > Account > Sign out. Then sign in again with the same work account.
OneDrive sync client is blocked by group policy
Some organizations use group policy to restrict which users can sync shared libraries. The IT administrator must verify that the policy setting Allow syncing OneDrive accounts for specific organization is configured to include the new employee’s domain. This setting is found in the Group Policy Management Console under Computer Configuration > Administrative Templates > Windows Components > OneDrive.
| Item | Shared Library via OneDrive Client | Shared Library via Browser Only |
|---|---|---|
| File access | Offline file availability | Online-only access |
| Sync status | Pending if permissions are missing | No sync status needed |
| Setup time | 5–10 minutes with authentication | Instant |
| File version history | Available in File Explorer | Available in browser only |
| IT control | Requires group policy and permissions | No client management required |
After completing the steps above, the new employee should see the shared library status change from Pending to Syncing. The first full sync may take several minutes depending on the library size. To speed up future syncs, instruct the user to right-click the library folder in File Explorer and select Always keep on this device for frequently used files. If the pending state returns, run the OneDrive reset command again and verify that the user’s SharePoint site permission has not been removed by an automated cleanup policy.