Fix Teams Cannot Sync a Channel Library in a Shared Channel

When you try to sync a SharePoint document library in a shared channel to your computer, Teams may show an error or the sync simply never starts. This problem usually happens because the shared channel library uses a separate SharePoint site that requires specific permissions and sync app settings. In this article, you will learn why the sync fails and how to fix it using the OneDrive sync app, Teams admin settings, and SharePoint site permissions.

Shared channels in Teams store files in a dedicated SharePoint site that is separate from the main team site. Sync for these libraries depends on the OneDrive sync app being installed, signed in with the correct account, and allowed by your organization’s policies. If any of these pieces are missing, the sync button may be greyed out or the sync process stops with an error.

This guide covers the technical cause, step-by-step fixes, and related issues you may encounter when syncing shared channel libraries.

Why Teams Cannot Sync a Channel Library in a Shared Channel

Shared channels in Teams create a separate SharePoint site for each channel. This site is not part of the main team site. The files in a shared channel library live on this dedicated site, and the sync feature relies on the OneDrive sync app to connect to that site.

The most common cause of sync failure is an outdated OneDrive sync app. Versions before 22.100 do not support syncing shared channel libraries. Even if the app is up to date, the user must be signed in with the same account that has access to the shared channel. If the user is not a member of the shared channel, the sync button will not appear or will fail immediately.

Another frequent cause is a policy restriction. Tenant administrators may disable shared channels or restrict the OneDrive sync app for certain users. The Teams admin center has a shared channel policy that can block the creation or use of shared channels. Additionally, the OneDrive sync app can be blocked by a SharePoint admin setting called “Sync” in the SharePoint admin center.

Finally, the user’s local machine may have a stale sync state. If the user previously synced the same library from a different site or with a different account, the OneDrive sync app may hold onto old credentials and fail to connect to the new shared channel site.

Steps to Diagnose and Fix the Sync Issue

Follow these steps in order. Each step addresses a specific cause. Stop when the sync works.

1. Check the OneDrive sync app version
   Open OneDrive settings by right-clicking the OneDrive cloud icon in the system tray and selecting Settings. Go to the About tab and note the version number. If it is below 22.100, download the latest version from the Microsoft OneDrive download page and install it. Restart Teams after the update.
2. Sign in to OneDrive with the correct account
   Right-click the OneDrive cloud icon and select Settings. In the Account tab, check which account is signed in. It must be the same account that has access to the shared channel in Teams. If not, sign out and sign in with the correct account. Then restart OneDrive and Teams.
3. Verify shared channel membership
   In Teams, open the shared channel and go to the Files tab. If you see a message that you do not have access, you are not a member. Ask the channel owner to add you. Only members can sync the library.
4. Use the Sync button in the shared channel
   In the shared channel, go to the Files tab and click the Sync button in the toolbar. If the button is greyed out, your organization may have disabled sync for shared channels. Proceed to the next step.
5. Check the Teams shared channel policy
   Go to the Teams admin center at admin.teams.microsoft.com. Under Teams > Teams policies, select the policy assigned to the user. In the Shared channel policy section, ensure that “Allow users to create shared channels” is set to On. If it is Off, change it to On and click Apply. Wait a few minutes and try again.
6. Check the SharePoint sync setting
   Go to the SharePoint admin center at admin.microsoft.com. Under Settings, find the “Sync” setting. If it is set to “Only allow sync on domains that are allowed,” make sure the user’s domain is in the allowed list. If it is set to “Block sync,” change it to “Allow sync” and save. This setting applies to all SharePoint sites, including shared channel sites.
7. Reset the OneDrive sync app
   If the above steps do not work, reset OneDrive. Press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. Wait for OneDrive to restart. Then try syncing again.

If Teams Still Has Issues After the Main Fix

Teams shows a blank window after switching work accounts

If you switched accounts in Teams and the shared channel library does not sync, the OneDrive sync app may still be signed in with the old account. Clear the OneDrive credentials by signing out of OneDrive and signing in again with the new account. Then restart Teams and try the sync again.

Sync button is missing in the shared channel Files tab

The Sync button may be hidden if the user is not a member of the shared channel or if the sync feature is disabled by policy. Verify membership and check the SharePoint sync setting as described in the steps above. Also confirm that the OneDrive sync app is running.

Sync starts but stops with error 0x80070005

This error indicates a permission problem. The user does not have the correct permissions on the shared channel site. In SharePoint, go to the site permissions for the shared channel site and ensure the user has at least Contribute access. If the user is a guest, they need to be added as a guest to the shared channel.

New Teams Desktop vs Teams on the Web: Key Differences for Sync

Item	New Teams Desktop	Teams on the Web
Sync button availability	Available in the Files tab	Not available in the browser
OneDrive sync app requirement	Required for sync	Not required because sync is not available
Shared channel library access	Full sync and file management	Only view and edit files in the browser

Use the desktop app for syncing shared channel libraries. The web version does not offer the sync feature.

After following the steps, you can sync the shared channel library to your computer. The files will appear in File Explorer under the shared channel name. If sync still fails, contact your tenant admin to verify that the OneDrive sync app is allowed for your account and that shared channels are enabled in your tenant.

To avoid future issues, keep the OneDrive sync app updated and always sign in with the same account you use for Teams. If you manage multiple tenants, use the “Switch account” option in OneDrive to ensure the correct identity is active. For advanced control, your admin can use the SharePoint admin center to manage sync settings for all sites.