Use @mentions

VSTS | TFS 2018 | TFS 2017 | TFS 2015.2

Note

The @mention control is available from TFS 2015.2 and later versions.

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

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 start type the name of a team or a security group, click 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. Click 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 account]

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.