Fix Teams Cannot Sync a Channel Library with OneDrive Sync Enabled

When you enable OneDrive sync in Microsoft Teams, the Files tab in a channel should let you sync the shared library to your computer. Sometimes the sync button does nothing, or it shows an error that the library cannot be synced. This problem usually happens because the channel library and your personal OneDrive are trying to use the same sync engine, and a conflict or a policy blocks the connection. This article explains why the conflict occurs and gives you clear steps to fix the sync so you can work with channel files offline.

Why Teams Cannot Sync a Channel Library When OneDrive Sync Is Enabled

Every Teams channel has its own document library stored in SharePoint. When you click Sync in the Files tab, the OneDrive sync app (now called Microsoft OneDrive) creates a connection between that SharePoint library and a folder on your computer. The same sync app also handles your personal OneDrive files. When you have OneDrive sync enabled, the app is already busy with your personal library, and sometimes it fails to add a second connection for a channel library.

The root cause is usually a conflict in the sync engine. OneDrive sync can only manage a certain number of libraries, and if your personal OneDrive is syncing thousands of files, the channel library may be rejected. Another common cause is a Teams policy that forces all channel libraries to sync automatically. That policy can override your manual sync request and create a broken state.

There are also known issues with the Teams desktop app on Windows 11 and Windows 10 where the Sync button opens a blank dialog. This happens because the app uses an outdated version of the sync client. Clearing the Teams cache or updating the app usually solves that part.

Steps to Fix Channel Library Sync in Teams

Follow these steps in order. Test the sync after each step to avoid doing extra work.

Step 1: Check the Teams Admin Policy for OneDrive Sync

1. Open the Teams admin center
   Go to Teams admin center > Org-wide settings > Teams settings.
2. Find the sync policy
   Look for the setting named Files or Sync. Some tenants have an option that says “Automatically sync all channel libraries.” If that is turned on, turn it off and save the change.
3. Wait for the policy to apply
   Policy changes can take up to 24 hours to reach all clients. Wait at least one hour before testing again.

Step 2: Unlink and Relink Your Personal OneDrive

1. Open OneDrive settings
   Right-click the OneDrive cloud icon in the system tray and select Settings.
2. Go to the Account tab
   Click Account and then click Unlink this PC.
3. Confirm the unlink
   Click Unlink account in the confirmation dialog.
4. Restart OneDrive
   Open OneDrive again and sign in with your work account. Do not sync your personal library yet.
5. Try syncing the channel library
   In Teams, go to the channel Files tab and click Sync. If it works, you can later re-link your personal OneDrive.

Step 3: Clear the Teams Cache

1. Close Teams completely
   Right-click the Teams icon in the system tray and select Quit.
2. Open the cache folder
   Press Ctrl + R, type %appdata%\Microsoft\Teams, and press Enter.
3. Delete the cache subfolders
   Delete the folders named Cache, Code Cache, GPUCache, and blob_storage. Do not delete the whole Teams folder.
4. Restart Teams
   Open Teams again and sign in. Try the Sync button again.

Step 4: Use the Browser Sync Flow

1. Open the channel in a browser
   Go to the SharePoint site that hosts the channel library. You can find the link by clicking Open in SharePoint in the Files tab.
2. Click Sync in the browser
   On the SharePoint library page, click Sync in the toolbar. This opens the OneDrive sync client directly.
3. Choose a folder
   Select the folder where you want the channel files to appear and click Start sync.

If Teams Still Cannot Sync the Channel Library

Teams Shows “This library is already synced” but the Files Tab Is Empty

This happens when the sync connection exists but the folder is missing or the sync engine lost track of it. Open the OneDrive settings, go to the Account tab, and click Stop sync next to the channel library. Then click Sync again in Teams. If the folder is missing, create a new folder with the same name before syncing.

Sync Button Is Grayed Out in Teams

A grayed-out Sync button usually means the tenant policy blocks syncing for that site. Ask your tenant administrator to check the SharePoint admin center. Go to SharePoint admin center > Policies > Sharing and make sure the option “Allow users to sync files” is enabled. Also check the site-level settings in the site permissions.

OneDrive Sync App Crashes When You Click Sync

If the OneDrive app crashes, the sync engine is likely corrupted. Run the OneDrive sync health check. Right-click the OneDrive icon, select Settings, go to About, and click Check for updates. If that does not help, uninstall OneDrive and reinstall it from the Microsoft 365 portal.

Teams Desktop Sync vs Browser Sync: Key Differences

Item	Teams Desktop Sync	Browser Sync (SharePoint)
Access point	Files tab in the Teams channel	SharePoint site in a web browser
Sync client	OneDrive sync app	OneDrive sync app
Error visibility	Often silent or blank dialog	Shows clear error messages
Policy bypass	Subject to Teams sync policy	Subject to SharePoint sync policy
Best for	Quick sync from within Teams	Troubleshooting when desktop fails

Use the browser method when the desktop button fails. It uses the same sync engine but gives you more control and better error details.

After you fix the sync, you can work with channel files offline and changes will sync automatically when you are online. To avoid future conflicts, keep your personal OneDrive sync folder under 100,000 files. If you manage multiple channels, use the Add shortcut to OneDrive option instead of full sync, which creates a lighter connection that is less likely to fail.