Use @mentions in work items and pull requests

TFS 2017 | TFS 2015

The @mention control allows you to quickly add a user or group to a work item or pull request discussion. Using the people picker of the @mention control, you can select a project member or group from the search list, and they'll receive an email notifying them of your comment.

For organizations that manage their users and groups using Active Directory, people pickers provide support for searching all users and groups added to the Azure AD, not just those users and groups added to your project.

Use the @mention control to start or continue a discussion within the following areas:

  • A work item discussion
  • A pull request discussion
  • Commit comments
  • Changeset or shelveset comments

Note

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

Note

For on-premises Azure DevOps Server, configure an SMTP server for team members to see the Notifications option from their organization or user profile menu and to receive notifications.

Identity search selection

When you leave a code comment in a pull request, enter @ to trigger the @mention people picker. From the people picker, you see a list of users you've recently mentioned. Choose a name or enter the name of the user you're looking for to do a directory search.

Warning

If you have permission to invite users to the organization, regardless of whether the Restrict invitations policy is disabled, you can @mention a user who isn't part of your organization. This action invites that user to your organization. To learn more, see Restrict new user invitations from project and team administrators.

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

Screenshot of people picker

To @mention a user you've never selected previously, just continue to enter the entire name to do your search against the full directory.

Names of mentioned users appear in blue text. Choose the @mention link name to open the user's contact information. The contact information provides more context for why they were added to the conversation.

Web portal, At mention user contact information accessible

Note

Don't copy/paste @mention users from a previous comment. While the resulting formatting looks identical to a properly entered mention, it doesn't register as a true mention nor send an email notification.

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.