When you add a comment in a shared Word document and type @username to notify a colleague, that person sometimes never receives the email notification. This problem usually occurs because the mention syntax is incorrect, the recipient does not have permission to the document, or the sharing settings block external email notifications. This article explains why mention notifications fail for specific recipients and provides step-by-step fixes to ensure your team members get notified every time.
Key Takeaways: Fixing Word Comment Mention Notifications
- @mention syntax must match the recipient’s Microsoft 365 display name exactly: Typing a partial name or nickname will not trigger the notification system.
- Document sharing permissions must include Edit or higher for the recipient: View-only users do not receive mention notifications.
- External recipients require explicit sharing with their full email address: Simply mentioning an external user does not automatically grant access or send notifications.
Why Word Comment Mention Notifications Fail for Some Recipients
Word uses the Microsoft 365 notification pipeline to send an email when a user is mentioned in a comment. The system checks three conditions before sending the notification:
- The mention text must exactly match the recipient’s display name in the Microsoft 365 directory.
- The recipient must have at least Edit access to the document or be a member of the shared site where the document resides.
- If the recipient is external to your organization, the document must be shared with that person’s full email address, and external sharing must be enabled in the tenant.
If any of these conditions is not met, the notification is silently dropped. Word does not display an error when a mention fails. The comment appears in the document, but the recipient never receives an email alert.
How the Mention Picker Works
When you type @ in a comment, Word opens a contact picker that searches the Microsoft 365 directory. The picker only shows people who have at least View access to the document. If the person you want to mention does not appear in the picker, you cannot select them. Typing a name manually that does not match the directory entry will not create a functional mention.
Steps to Fix Comment Mention Notifications Not Sending
Follow these steps in order. After each step, test by adding a new mention in a comment and asking the recipient to check their email inbox and spam folder.
- Verify the recipient appears in the mention picker
Open the document in Word for the web or the desktop app. Click in an existing comment or start a new comment. Type @ and wait for the contact picker to appear. If the recipient’s name does not show up, they do not have access to the document. Go to step 2 to fix permissions. - Share the document with Edit permissions
Click the Share button at the top right of the Word window. Enter the recipient’s email address. Set the permission level to Can Edit. Click Send or copy the link and send it to the recipient. The recipient must open the document at least once before mentions will trigger notifications. - Use the correct display name when mentioning
Type @ and then type the first few characters of the recipient’s display name as shown in your organization’s Microsoft 365 directory. Select the correct name from the picker. Do not type the full name manually unless you are certain it matches exactly. A mismatch of even one character or a nickname will break the notification. - Confirm external sharing is enabled for your tenant
If the recipient is outside your organization, ask your Microsoft 365 administrator to verify that external sharing is enabled for SharePoint and OneDrive. The setting is at Microsoft 365 Admin Center > SharePoint > Policies > Sharing. External users must also accept the sharing invitation before they can receive mention notifications. - Test with a new comment after making changes
After adjusting permissions or sharing settings, create a new comment with the @mention. Do not rely on existing comments that were created before the fix. The notification system only evaluates mentions at the moment the comment is saved.
If Word Still Has Issues After the Main Fix
Word comment mention does not show any names in the picker
If the mention picker is completely empty, the document is likely stored in a location that does not support real-time collaboration, such as a local folder or a network share. Move the document to OneDrive, SharePoint, or Microsoft 365 Groups. Only documents stored in these locations support @mention notifications.
Recipient receives a notification but cannot see the comment
This happens when the recipient has View-only access. The email notification arrives, but when the recipient opens the document, the comment is hidden because the document is in read-only mode. Change the sharing permission to Can Edit or Can Review. The recipient must close and reopen the document to see the comment.
Notifications are delayed by several hours
Microsoft 365 sends mention notifications in batches. Delays of up to 30 minutes are normal. If delays exceed one hour, check the Microsoft 365 Service Health dashboard for any ongoing incidents with the Exchange Online or SharePoint Online services.
Recipient changed their display name after the document was shared
If a user changes their display name in Microsoft 365, existing mentions that used the old name will not be updated. The notification for the old mention will fail. The user must be mentioned again using the new display name. The document does not need to be reshared because permissions are tied to the user account, not the display name.
Word Online vs Desktop: Mention Notification Behavior Differences
| Item | Word for the Web | Word Desktop App |
|---|---|---|
| Contact picker availability | Always available when document is on OneDrive or SharePoint | Available only when document is synced or opened from OneDrive/SharePoint |
| Email notification trigger | Sent immediately after comment is saved | Sent after comment syncs to the cloud (usually within a few seconds) |
| Support for external recipients | Yes, if external sharing is enabled | Yes, but the document must be opened from the cloud location |
| Offline mention behavior | Not applicable | Mentions typed offline are saved as plain text and do not trigger notifications until the document is saved to the cloud |
Word for the web provides the most reliable mention experience because the contact picker and notification pipeline are directly connected to the cloud. The desktop app can also send notifications, but only when the document is saved to OneDrive or SharePoint and the user is online.
To ensure notifications are sent reliably, always create mentions while the document is open from its cloud location. Avoid typing @mentions in a locally saved copy and then uploading it. The notification system will not retroactively process those mentions.