YouTrack Standalone 2018.3 Help

Integrate with a Build Server

If you are working on a software development project and use either TeamCity or Jenkins, there are some useful integration features that can reduce the amount of duplicated effort that is performed by your team. A build server integration enables useful features in both YouTrack and the connected build server:

  • YouTrack pulls build numbers from connected projects. Issues that were resolved after the last known successful build are automatically assigned the build number of the next successful build. This value is added to a custom field that stores the build number for each resolved issue.

    You can specify whether issues that are mentioned in commit messages and build comments are assigned build numbers and use a search query to assign build numbers to issues that match specific criteria.

  • Your developers reference an issue ID in the comments when they commit updates to the code repository. The build server integration adds a direct link to the YouTrack issue in the change details.
    The comment is automatically added to the list of VCS changes in the activity stream for the issue in YouTrack. Each VCS change includes a direct link to the change details in the build server.

  • Your developers can enter commands in the comments for their commits in the repository. When the build server assembles a build that contains the commit message, the command is applied all of the issues that are referenced in the command. You can use this feature to update the status or add comments to one or more issues without even opening YouTrack.

You can configure options for builds that are connected to your projects on the Build Server Integration tab of the Edit Project page.

build server integration

When the integration is enabled in your project, the following controls are available on the Build Server Integration tab:



Add New Mapping

Opens the Create Mapping dialog in the sidebar. Use these settings to map your YouTrack project to a new build configuration in a build server that is already integrated with your project.


Pulls fresh data from the build server. Links to builds are added to issues in YouTrack that are mentioned in build comments and commit messages. Commands in VCS commit messages are applied to the corresponding issues. Build numbers are added to issues according to the options that are defined in the mapping. The last processed build is updated in the corresponding column on the integration settings page.


Opens the settings dialog for the selected build server or mapping in the sidebar.


Deletes the selected build server or mapping from YouTrack.


Removes the IDs of the last recorded change and processed build from the selected project mapping. The next time the integration is scheduled to update, YouTrack pulls the entire change and build history from the build server. Changes and builds that already exist in YouTrack are not affected.


Disables the build server integration in the selected server or project. Use this option to disable the integration features in your project. If the integration is disabled, the Enable option is available.

Last modified: 7 March 2019