TeamCity 2019.1 Help

External Changes Viewer

TeamCity supports integration with external changes viewers like JetBrains Upsource, Atlassian Fisheye, and so on.

Since TeamCity 2017.2, some of the viewers are supported out of the box: commits to GitHub, VSTS or Bitbucket are automatically recognized and links are provided enabling you to view the changes externally.

To enable other external change viewers, create and configure the <TeamCity Data Directory>/change-viewers.properties file. These settings should be specified for each VCS root you want to use the external changes viewer for. A detailed example of the configuration file including the description of available formats, variables, and other parameters can be found in the change-viewers.properties.dist file in the <TeamCity Data Directory>/config directory.

When the configuration file is created, links to the external viewer (extChangesViewerIcon.png) will appear on the following pages:

  • Changes popups on the Projects and project home page, Overview tab and the Change Log tab of the build configuration home page)

Viewing external changes

  • Changes tab of the build results page

  • Change Details page available by clicking the link when hovering over the changes on the Overview and Change Log tabs for a project and build configurations and on the Changes tab of the build results page

  • TeamCity file diff page