TeamCity 2020.1 Help

Build Tag

Build tags are labels that can help you to:

  • organize the history of your builds

  • quickly navigate to the builds marked with a specific tag

  • search for a build with a particular tag

  • create an artifact dependency on a build with a particular tag

You can assign any number of tags for a single build, for example, EAP or release using the Edit tags dialog by entering several tags separated by any symbol like space, comma, or semi-colon.

Clicking a tag filters out all builds in the history: only the builds marked with the tag are displayed. Additionally, you can search for builds with particular tags using the search field.

To tag a build:

The TeamCity web UI provides the following ways to tag a particular build:

  • On the Build Configuration Home page:
    1. Go to either the Overview or History tab.

    2. In the build history table, open the context menu of the required build and select Add tags (or Edit tags to modify existing ones).

  • On the Build Results page of the particular build:
    1. Click Actions.

    2. Select Tag and add/modify the build tags.

  • On the Queued Build page:
    1. Click Actions.

    2. Select Tag and add/modify the build tags.

  • In the Run Custom Build dialog:
    • Go to the Comments and Tags tab and add/modify the build tags.

  • In the Pin/Unpin Build dialog where you can tag the build in addition to pinning it. For builds with snapshot dependencies, there is an option to pin and tag the build as well as its snapshot dependencies.

Alternatively, you can add and modify build tags using TeamCity REST API.