Use @mentions

Azure DevOps Services | TFS 2018 | TFS 2017 | TFS 2015.2

The @mention control allows you to quickly pull someone into a work item or pull request.


The @mention control is available from TFS 2015 Update 2 and later versions.

In order for team members to receive notifications, you must configure an SMTP sever.

When leaving a code comment in a pull request, you can type @ to trigger the @mention identity picker. From the identity selector, you'll see a list of those people that you have you've recently mentioned. You can choose one of those names or type in the name of the person you are looking for to perform a directory search.

To filter the list, enter the user name or alias until you've found a match.

Web portal, Pull Request, Type a user name or email alias to locate a match

You can also use group mentions. Simply type the name of a team or a security group, choose the search icon and then select from the options listed.

To @mention a user you've never selected previously, just continue typing to perform your search against the full directory.

Names of those that you mention appear in blue text. Choose the@mention link name to open the user's contact card, which can provide you additional context for why they were pulled into the conversation.

Web portal, At mention user contact card accessible

Upon completion of your selection and text entry, your @mention user will receive an email alerting them about the mention.

Email sent to at-mention user organization

When viewing their own mentioned names in conversations, users will notice that their own name is are highlighted in orange text.

Web portal, At mention of ones own name appears in orange text

You can use the @mention control in pull request discussions, commit comments, changeset comments, and shelveset comments. You can also use the @mention control in any text field on the work item form.