How to Fix @Mentions Not Working for Some External Guests in Teams Word Documents
Question details
The user is experiencing inconsistent functionality where @mentions in Word document comments within Microsoft Teams work for certain external guests but fail for others.

- Product
- Microsoft Teams / Microsoft Word
- Device & OS
- not provided
- Scenario
- Collaborating on Word documents with external or guest users via Microsoft Teams channels.
- Observed behavior
- Some guest users can be successfully @mentioned in document comments, while others cannot be found or tagged in the comments, despite both appearing to have external guest status.
Ensure you have Microsoft 365 Admin or Teams Administrator privileges, as resolving this issue requires checking tenant-level guest access settings and Microsoft Entra ID (Azure AD) B2B configurations.
Verify Microsoft Entra ID B2B Guest Account Status
Confirm whether the affected external user is properly added as a B2B guest rather than just an external federated contact.
In Microsoft Teams, there is a strict distinction between an external access (federated) user and a Guest (B2B) user. Only fully registered B2B guests who have accepted their invitation can be consistently tagged in document comments.
Log in to the Microsoft Entra admin center (formerly Azure AD) with administrator credentials.
Go to 'Identity' > 'Users' > 'All users' and search for the affected external user's email address.
Ensure their 'User type' is listed as 'Guest' and their 'Invitation state' is 'Accepted'. If they are missing or pending, resend the B2B guest invitation.

Review Tenant Policies for Guest Access
Ensure that your organization's Microsoft Teams settings allow guests to collaborate and be mentioned.
Check Channel Membership and Document Access
Guests must be direct members of the specific Team/channel and have explicit editing rights to the Word document to be @mentioned.
Try WPS Office for Hassle-Free Document Collaboration
If managing complex tenant permissions and guest access settings in Microsoft Teams is slowing down your workflow, WPS Office provides an easier way to collaborate. It is a free, lightweight alternative that offers seamless compatibility with Microsoft Word, Excel, and PowerPoint files.
- 1. Download WPS Office: Visit the official WPS website and download the free installation package for your operating system.
- 2. Install the Software: Run the installer and follow the simple on-screen instructions to complete the setup.
- 3. Start Collaborating: Open your Word, Excel, or PowerPoint files and seamlessly share them via a simple link.

Frequently Asked Questions
Why does a guest appear as 'Unknown User' when I try to @mention them in Word?
This usually happens when the guest has been added to the Team but has not yet redeemed their Azure AD B2B invitation, or there is a synchronization delay between Microsoft Entra ID and Teams.
Can federated external users be @mentioned in Word document comments?
Federated users (external access contacts) can chat and communicate, but they often cannot be @mentioned in collaborative documents unless they are explicitly added as a guest (B2B) to the specific tenant hosting the file.
Why are @mentions greyed out entirely in my Teams document?
This can occur if the document is saved in an older format (like .doc instead of .docx) or if the document is currently opened in 'Viewing' mode rather than 'Editing' or 'Reviewing' mode.
Do I need a Microsoft 365 subscription to @mention someone?
To @mention someone in a Word document stored in SharePoint or Teams, the file must be hosted on a platform that supports Microsoft 365 collaboration features, and the mentioned user must have appropriate permissions to access the file.




