Use @mentions in work items and pull requests

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015

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

Note

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

For team members to receive notifications, you must configure an SMTP server.

When you're leaving a code comment in a pull request, you can enter @ to trigger the @mention identity picker. From the identity selector, you see a list of those people that you've recently mentioned. Choose one of those names or enter 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. Enter 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 to enter the entire name 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 receives an email alerting them about the mention.

Email sent to at-mention user organization

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.