TeamCity On-Premises 2020.2 Help

Team Foundation Work Items

Team Foundation Work Items tracking is integrated with TeamCity. Supported versions are Microsoft Visual Studio Team Foundation Server 2012 or later, and Azure DevOps Services.

TFS work items support can be configured on the Issue Trackers page for a project. If a project has a TFVC root configured, TeamCity will suggest configuring the issue tracker as well.


By default, the integration works the same way as the other issue tracker integrations: you need to mention the work item ID in the comment message, so the work items can be linked to builds and the links will be displayed in various places in the TeamCity web UI.

Additionally, if your changeset has related work items, TeamCity can retrieve information about them and display information on the Issue Log tab even if no comment is added to the changeset. Besides, custom states for resolved work items are supported by TeamCity.




Display Name

Specify the tracker connection name

Server URL

Team Foundation Server URL in the following format:

TFS 2010+: http[s]://<host>:<port>/tfs/<collection>/<project>

Azure DevOps Services: https://<account><project>


Specify a user to access Team Foundation Server. This can be a username or DOMAIN\UserName string.
Use blank to let TFS select a user account that is used to run the TeamCity Server. For VSTS use personal access tokens.


Enter the password of the user entered above


Specify the work item id format in changeset comments in the form of regexp.

Learn more about authentication in Azure DevOps Services.

Custom Resolved States

In addition, resolved states in TeamCity can be customized by using the teamcity.tfs.workItems.resolvedStates internal property set to Closed?|Done|Fixed|Resolved?|Removed? by default.

Last modified: 06 April 2021