Permission & Access Issues

How to Fix @Mentions Not Working for Some External Guests in Teams Word Documents

Ayan MasoodAyan Masood Nov 3, 2026 869 views

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.

How to Fix @Mentions Not Working for Some External Guests in Teams Word Documents
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.
Before you start

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.

Solution 1Recommended

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.

1
Open Microsoft Entra Admin Center

Log in to the Microsoft Entra admin center (formerly Azure AD) with administrator credentials.

2
Navigate to Users Directory

Go to 'Identity' > 'Users' > 'All users' and search for the affected external user's email address.

3
Check User Type and Invitation State

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.

Verify Microsoft Entra ID B2B Guest Account Status
Sync Delays: After a guest accepts an invitation, it can take up to 24 hours for their profile to fully sync across Teams and SharePoint services.
Free Microsoft Office alternative

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. 1. Download WPS Office: Visit the official WPS website and download the free installation package for your operating system.
  2. 2. Install the Software: Run the installer and follow the simple on-screen instructions to complete the setup.
  3. 3. Start Collaborating: Open your Word, Excel, or PowerPoint files and seamlessly share them via a simple link.
Highly compatible with Microsoft Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) formats.Simple cloud sharing and co-editing features without complex tenant setups.Lightweight installation with an intuitive, familiar interface.Free to use with comprehensive tools for PDF, Word, Spreadsheets, and Presentations.
microsoft office alternative - wps office

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.