Fix Cannot Upload a File in Teams Chat in a Shared Channel

You try to attach a file to a message in a Teams shared channel, but the upload fails or the attach button is grayed out. This problem usually comes from the channel type, a policy setting, or a missing SharePoint site. In this article, you will learn the exact reasons for the failure and the steps to fix it in the Teams admin center and the desktop app.

Shared channels in Teams use a separate SharePoint site that is different from the team’s main site. If that site is blocked, deleted, or misconfigured, file uploads stop working. You will also see this issue when your organization blocks guest access or when the channel owner turned off file sharing.

This guide covers the root causes, a full set of diagnostic steps, and related problems you may face after the fix. Use the table at the end to compare the behaviors of standard, private, and shared channels.

Why File Uploads Fail in a Teams Shared Channel

A shared channel in Teams is different from a standard channel. Each shared channel has its own SharePoint site that stores files and messages. This site is separate from the parent team’s site. When you upload a file in the chat of a shared channel, the file is sent to that dedicated site.

The upload can fail for several reasons. The most common cause is that the SharePoint site for the shared channel is missing or has been deleted. This happens when a site is accidentally removed or when the site is in a locked state after a retention policy change. Another cause is a Teams policy that blocks file sharing for the channel or for the user. Guest access must be enabled if the channel includes external participants.

A third cause is a corrupted Teams cache. The desktop app stores temporary data about channels and file locations. If that cache becomes out of sync, the upload operation fails even though the SharePoint site is healthy.

How Shared Channel File Storage Works

When you create a shared channel, Teams automatically provisions a new SharePoint site. The site’s URL follows a pattern like teamname-channelname. The site is not visible in the parent team’s file list. Only members of the shared channel can access this site.

The chat messages and file uploads in the channel are stored in this site’s document library. If the site is deleted or the library is removed, the upload fails. The admin can restore the site from the SharePoint admin center within 93 days of deletion.

Steps to Diagnose and Fix File Upload Failures in a Shared Channel

Follow these steps in order. Each step checks a different layer of the system. Stop when the upload works.

1. Clear the Teams cache
   Close Teams completely. Press Ctrl + Shift + Esc to open Task Manager and end all Teams processes. Open File Explorer and paste %appdata%\Microsoft\Teams into the address bar. Delete the folders Cache, Code Cache, GPUCache, and IndexedDB. Restart Teams and try the upload again. This fixes corrupted local data that blocks the upload.
2. Test the upload in the Files tab
   Open the shared channel and click the Files tab at the top. Click Upload and choose a file. If the upload works here, the problem is isolated to the chat compose box. If it fails here, the SharePoint site is the issue.
3. Check the SharePoint site for the shared channel
   Sign in to the SharePoint admin center at admin.microsoft.com. Go to Active sites and search for the site name that matches the channel. The site should have the status Ready. If it shows Locked or Deleted, select it and click Restore or Unlock. Wait 10 minutes for the site to become active.
4. Verify the Teams policy allows file sharing
   Open the Teams admin center and go to Teams > Teams policies. Select the policy assigned to the affected user. Confirm that File sharing is set to On. Also check Guest access under Users > Guest access if the channel has external members. Change the setting if needed and wait up to 24 hours for the policy to propagate.
5. Check the user’s license and permissions
   In the Microsoft 365 admin center, go to Users > Active users. Select the affected user and verify they have a valid Teams or Microsoft 365 license. Next, open the shared channel and click the ellipsis (three dots) next to the channel name. Select Manage channel and confirm the user is listed as a member. If they are not, add them.
6. Use the web version of Teams
   Open Teams in a browser at teams.microsoft.com and try the upload in the same shared channel. If the web version works, the desktop app has a deeper cache issue. Reinstall the desktop app by uninstalling it from Settings > Apps > Installed apps and then downloading the latest version from the Microsoft website.

If Teams Still Has Issues After the Main Fix

Some problems appear after the main fix is applied. Here are the most common ones and how to solve them.

Upload Works in the Files Tab but Not in the Chat Compose Box

This points to a corrupted chat composer state. Close Teams and clear the cache again using the steps in Step 1. If that does not work, check if the message box is in a full-screen mode. Press Escape to exit full-screen compose and try again. Another possibility is that the file type is blocked by the organization’s file policy. Ask your admin to check the Blocked file types list in the SharePoint admin center.

Guests Cannot Upload Files in a Shared Channel

Shared channels allow external participants, but those guests must have a Microsoft 365 account. If a guest uses a personal account, the upload fails. The admin must enable guest access in the Teams admin center under Users > Guest access. Also, the guest must be added to the channel as a member, not just as an owner of the parent team.

The Shared Channel SharePoint Site Is Missing

If the site does not appear in the Active sites list, it may have been deleted. Go to the Deleted sites section in the SharePoint admin center. Select the site and click Restore. After restoration, the channel will work again. If the site is not in the deleted list, you must recreate the shared channel. Deleting and recreating the channel will lose all previous messages and files.

File Upload Shows a Red Error Icon in the Chat

This happens when the upload process times out. The file may be too large. Teams has a default file size limit of 250 GB per file, but the network speed affects the upload. Try a smaller file. If the error persists, check the network connection and disable any VPN that may block SharePoint endpoints.

Standard Channel vs Private Channel vs Shared Channel: Key Differences

Item	Standard Channel	Private Channel	Shared Channel
File storage site	Parent team’s SharePoint site	Separate site for the private channel	Separate site for the shared channel
Guest access	Uses team-level guest settings	Uses team-level guest settings	Requires explicit guest assignment
Visibility	Visible to all team members	Visible only to channel members	Visible to channel members and external people
Upload failure risk	Low	Medium if site is misconfigured	High if site is deleted or policy blocks it

You can now diagnose and fix file upload failures in a Teams shared channel. Start by clearing the cache and testing the Files tab. Then verify the SharePoint site and the Teams policies. If the problem continues, check the user’s license and membership. For advanced troubleshooting, use the Teams admin center to review the audit log for the specific upload event. That log shows the exact error code and the resource that caused the failure.