You are trying to send a file to an external guest in Teams chat, but the upload fails or the attach button is grayed out. This often happens because of tenant-level sharing settings, guest access policies, or a blocked file extension. In this article, you will learn the exact causes and the step-by-step fixes to restore file uploads for external guests.
Key Takeaways: Fixing File Upload Failures for External Guests in Teams
- Teams admin center > Org-wide settings > External access: Allows or blocks external sharing with other organizations.
- Teams admin center > Guest access > Guest access settings: Controls whether guests can use file sharing in Teams.
- SharePoint admin center > Sharing > External sharing: Sets the default sharing link type and guest link permissions for OneDrive and SharePoint.
Why Teams Cannot Upload a File for an External Guest
When you upload a file in Teams chat, the file is stored in OneDrive for Business or SharePoint, depending on the context. For external guests, the sharing link must be accessible to the guest’s identity. If the guest cannot authenticate or the link type is restricted, the upload fails silently or shows an error.
The root cause is usually one of three things. First, your tenant’s external sharing settings block guests from receiving files. Second, the guest’s own tenant blocks inbound sharing. Third, the file type you are sending is on a blocked list.
Another common cause is that the guest account has not been properly invited or has not accepted the invitation. Without a valid guest account in your Azure AD, Teams cannot create a sharing link for that person.
How External Sharing Works in Teams
When you attach a file in a chat, Teams creates a link to a file in your OneDrive for Business. The link is then sent to the guest. The guest must have a Microsoft account or a work account that can authenticate. If the guest’s tenant has conditional access policies that block access, the file will not open.
For channel posts, files are stored in SharePoint. The same sharing principles apply, but the site’s sharing settings also matter. If the SharePoint site is set to “Only people in your organization,” guests cannot access the file.
Steps to Diagnose and Fix Teams File Upload Issues for External Guests
Follow these steps in order. After each step, test the upload again.
- Check the guest account status in Azure AD
Go to the Azure AD admin center, select Users, then All users. Find the guest account and confirm the invitation status is “Accepted.” If it shows “Pending Acceptance,” resend the invitation. The guest must accept before you can share files. - Verify external access settings in Teams admin center
Open the Teams admin center, select Org-wide settings, then External access. Ensure that “Users can communicate with other organizations” is turned on. Also check that the guest’s domain is not blocked. If the domain is blocked, remove it. - Enable guest access in Teams admin center
Go to Teams admin center, select Users, then Guest access. Turn on “Allow guest access in Microsoft Teams.” Then under “Guest access settings,” verify that “Allow file sharing” is set to On. Save the changes and wait up to 24 hours for propagation. - Adjust SharePoint external sharing settings
Open the SharePoint admin center, select Policies, then Sharing. Under “External sharing,” choose “Anyone” or “New and existing guests” for OneDrive and SharePoint. Also set the default link type to “Anyone with the link” if you want guests to access without signing in. Save the changes. - Check the file extension block list
Teams blocks certain file extensions for security. If you are sending a file like .exe, .ps1, or .bat, the upload will fail. Rename the file to a safe extension or compress it into a .zip file. The block list is managed by SharePoint, not Teams. - Check the guest’s tenant settings
Ask the guest to have their IT admin check their external sharing settings in SharePoint and OneDrive. Their tenant must allow receiving files from outside. If their tenant blocks inbound sharing, the file will not open even if upload succeeds. - Test with a different file or a new chat
Create a new chat with the guest and try uploading a small text file. If it works, the issue is with the original file or the chat. If it fails, the problem is at the tenant level.
If Teams Still Cannot Upload Files for External Guests
Teams shows a message that the file is blocked
This message appears when the file extension is on the SharePoint block list. You cannot override this list in Teams. Compress the file into a .zip archive and send that instead. Alternatively, upload the file to a SharePoint document library and share the link in chat.
Guest receives a “You don’t have access” error when opening the file
The link type or the guest’s permissions are incorrect. In SharePoint, ensure the sharing link is set to “Anyone with the link” or “People in your organization with the link.” Also check that the guest’s account is not expired. Guests can be disabled after a certain period if your admin set a guest expiration policy.
Upload works for internal users but not for guests
This indicates that guest access is disabled or the external sharing settings are too restrictive. Recheck the Teams guest access settings and the SharePoint sharing settings. Also verify that the guest is a member of the correct team or channel. If the guest is only in a chat, they may not have permission to the underlying SharePoint site.
Teams Desktop vs Teams on the Web: File Upload Differences for External Guests
| Item | Teams Desktop | Teams on the Web |
|---|---|---|
| File upload method | Uses the same OneDrive and SharePoint backend | Same backend, but may have browser restrictions |
| Blocked file extensions | Same block list as SharePoint | Same block list, but some extensions may be blocked by the browser |
| Guest authentication | Uses the Teams app login | Uses browser cookies and may require additional sign-in |
| Error messages | Detailed error codes | Generic errors, harder to diagnose |
If the desktop app fails, try the web version. If the web version works, the issue is with the desktop app’s cache or authentication. Clear the Teams cache by closing Teams and deleting the %appdata%\Microsoft\Teams folder, then restart Teams.
You can now identify and fix the most common causes of file upload failures for external guests in Teams. Start by checking the guest account status and the external access settings. Then adjust the SharePoint sharing settings and verify the file type is allowed. If the problem persists, ask the guest’s IT admin to review their tenant settings. For advanced scenarios, use the Teams admin center to review audit logs and identify the exact error code.