Controlling settings, permissions, and membership within Teams and channels
The most likely causes are tenant-level guest settings rather than the team’s local settings.
Check these areas in order:
- Verify Teams guest access is enabled tenant-wide
- Guests can be added to a team only if an admin has enabled guest access in Teams.
- If guest access is off, team owners can’t add external users.
- Verify Microsoft 365 Groups guest settings
- In the Microsoft 365 admin center, go to Settings > Org settings > Microsoft 365 Groups.
- Make sure both of these are enabled:
- Let group owners add people outside your organization to Microsoft 365 Groups as guests
- Let guest group members access group content
- Teams uses a Microsoft 365 group for team membership, so if these settings are off, adding guests can fail even when the team itself looks correctly configured.
- Verify SharePoint/OneDrive external sharing
- If the issue includes guest access to the Files tab, check SharePoint admin center > Policies > Sharing.
- SharePoint and OneDrive sharing must be set to one of these levels:
- Existing guests
- Anyone
- New and existing guests
- If sharing is more restrictive, guests can hit access errors for files.
- Check whether the organization blocks guest invitations
- If adding the guest shows “We didn't find any matches”, the organization does not allow guests.
- If invitations are blocked at the tenant level, guest onboarding can fail even though other teams appear normal.
- Compare the affected team’s backing Microsoft 365 group behavior
- Since other teams with the same visible configuration work, the issue may be specific to how this team’s Microsoft 365 group is handling guest membership.
- A useful test is whether the same external user can be added to a different team successfully. If yes, the tenant-wide configuration is probably fine and the problem is isolated to this team or its group.
- Run the Teams guest access diagnostic
- Microsoft provides a Microsoft Teams Guest Access Diagnostic for Microsoft 365 admins.
- It checks common misconfigurations across:
- Microsoft Entra guest invite settings
- Microsoft 365 Groups guest settings
- SharePoint external sharing
- Teams guest access
- It can also verify guest provisioning and whether a guest is a member of a specific team.
- If the failure is only for shared channels, use the correct model
- Guests can’t be added to shared channels.
- For shared channels with external people, the required model is B2B direct connect.
Also note:
- Team owners can add guests by using More team options > Add member and entering the external email address.
- After a guest is added, access can take a few hours and the guest must accept the invitation before the team is accessible.