TeamCity 8.0 Help

Integrating TeamCity with Issue Tracker

Dedicated Support for Issue Trackers

TeamCity supports Jira, Bugzilla and YouTrack issue trackers out of the box. The Supported Platforms and Environments page lists supported versions. When integration is configured, TeamCity automatically transforms an issue ID (=issue key in JIRA) mentioned in the VCS commit comment into a link to the corresponding issue and the basic issue details are displayed in the TeamCity Web UI when hovering over the icon next to the issue ID (e.g. on the Working with Build Results tab of the build results).

Issue tracker integration

Issues fixed in the build can also be viewed on the Working with Build Results tab of the build results.

On the build configuration home page, you can review all the issues mapped to the comments at the Issue Log tab. You can filter the list to a particular range of builds and view issues mentioned in comments with their states.

Issue log

Recommendations on Using Issue Tracker Integration

To get maximum benefit from the issue tracker integration, do the following:

  • When committing changes to your version control, always mention the issue id (issue key) related to the fix in the comment to the commit.

  • Resolve issues when they are fixed (the time of resolve does not really matter).

  • Use Issue Log of a build configuration to get issues related to builds; turn on the "Show only resolved issues" option to only display the issues fixed in the builds.

Enabling Issue Tracker Integration

To enable integration, you need to create a connection to your issue tracker on the Administration | Issue Tracker page.

The settings described below are common for all issue trackers:

Connection type

Select the type of your issue tracker from the list.

Display name

A symbolic name that will be displayed in the TeamCity UI for the issue tracker.

Server URL

The Issue tracker URL


Credentials to log in to the issue tracker, if it requires authorization.

In addition to these general settings, you also need to specify which strings are to be recognized by TeamCity and converted to the links to issues in your issue tracker. For details, refer to corresponding section:

Integrating TeamCity with Other Issue Trackers

To integrate TeamCity with an issue tracker other than Jira/YouTrack/Bugzilla, configure TeamCity to turn any issue tracker issue ID references in change comments into links. See Mapping External Links in Comments for details.

Dedicated support for an issue tracker can also be added via a custom Issue Tracker Integration Plugin.

Last modified: 20 April 2023