TeamCity On-Premises 2021.1 Help

External Changes Viewer

TeamCity supports integration with external changes viewers like JetBrains Upsource or Atlassian Fisheye.

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>/config/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

Last modified: 05 March 2021