TeamCity On-Premises 2020.2 Help

Subscribing to Notifications

TeamCity provides a wide range of notification possibilities to keep developers informed about the status of their projects. Notifications can be sent by email and instant messages, or can be displayed in the IDE (with the help of TeamCity plugins) or in the web browser. Notifications can also be received via Atom/RSS syndication feeds.

Notifications in TeamCity can be sent:

  • Per user, according to the user's configured notification rules. These rules can also be set at the user-group level, so they are applied to all the users in the TeamCity group.
    You can create a user-level notification rule for a specific project or multiple projects and build configurations. These notifications are also available in a wider range of software than the build-level ones: IDE, browsers, Slack, Jabber, and email.

  • Per build configuration, with the Notifications build feature. Currently, these notifications are available only for email and Slack.
    Choose build-level notifications if you want to notify many people at once about a specific build configuration. You can enter an email list address or a Slack channel ID, and whoever is subscribed to this list or channel will be notified when the selected build events occur.

This article explains how to configure user-level notifications and describes the events that can trigger notifications. To read about build-level notifications, refer to the respective article.

Subscribing to User-level Notifications

TeamCity allows you to flexibly adjust the notification rules, so that you receive notifications only on the events you are interested in. To subscribe to user-level notifications:

1. In the upper right corner of the screen, click the arrow next to your username, and select My Settings & Tools from the drop-down menu. Open the Notification Rules tab.

2. Click the required notifications type and configure the required settings:

  • Email Notifier *: relies on the email address specified in My Settings & Tools | General.

  • IDE Notifier: the required TeamCity plugin must be installed in your IDE. For the details on installing TeamCity IDE plugins, refer to Installing Tools.

  • Jabber Notifier *: expects entering a Jabber account name. Note that instead of Jabber you can specify your Google Talk account here if this option is configured by the System Administrator.

  • Slack Notifier: requires signing in to Slack and relies on the Slack connection configured in the project settings. Read more on how to configure the connection to Slack in Notifications.

  • (obsolete) Windows Tray Notifier: Windows Tray Notifier must be installed.

  • Browser Notifier: aims at replacing Windows Tray Notifier and requires installing the web browser extension.

3. Click Add new rule and specify the rule in the dialog. The notification rules are comprised of two parts: what you will watch and which events you will be notified about. See the details below.

What Will Be Watched

Events related to the following projects and build configurations

Select the projects / build configurations whose builds you want to monitor. Notification rules defined for a project will be propagated to its subprojects. To monitor all of the builds of all the projects' build configurations, select Root project.

Use the following options for granular control over the notifications in the selected projects / build configurations:

  • Branch filter — select this option to receive alerts only on the builds from the specified branches. Read more in Branch Filter.

  • Builds with my changes only — select this option to limit notifications to builds containing your changes only.

System wide events

Select to be notified about investigations assigned to you.

Which Events Will Trigger Notifications

Build fails

Check this option to receive notifications about all of finished failed builds in the specified projects and build configurations. If an investigation for a build configuration was assigned to someone while the build was in progress, the failed build notification is sent only to that user.

Note that if Builds with my changes only is selected in the Watch area, TeamCity will notify you if a build with your changes fails, and will keep sending notifications on each 'incomplete' build afterwards until a successful one. An incomplete build is a finished build which failed with at least one of the following errors:

  • Execution timeout

  • JVM crashed

  • JVM Out of memory error

  • Unable to collect changes

  • Compilation error

  • Artifacts publishing failed

  • Unknown Failure reason

Only notify on the first failed build after successful

Check this option to be notified about only the first failed build after a successful build or the first build with your changes. When using this option, you will not be notified about subsequent failed builds.

Only notify on new build problem or new failed test

Check this option to be notified only if a build fails with a new build problem or a new failed test.

Build is successful

Check this option to receive notifications when a build of the specified projects and build configurations executed successfully.

Only notify on the first successful build after failed

Check this option to receive notifications when only the first successful build occurs after a failed build. Notifications about subsequent successful builds will not be sent.

The first error occurs

Check this option to receive notifications about a "failing" build as soon as the first build error is detected, even before the build has finished.

Build starts

Check this option to receive notifications as soon as a build starts.

Build fails to start

Check this option to receive notifications when a build fails to start.

Build is probably hanging

Check this option to receive notifications when TeamCity identifies a build as hanging.

Investigation is updated

Check this option to receive notifications on changing a build configuration or test investigation status, e.g. someone is investigating the problem, or problems were fixed, or the investigator changed.

Tests are muted or unmuted

Check this option to receive notifications on the test mute status change in the affected build configurations.

Investigation assigned to me

This option is available only if the System wide events option is selected in the Watch area. Check the option to be notified each time you start investigating a problem.

Rules Processing Order

TeamCity applies the notification rules in the order they are presented. TeamCity checks whether a build matches any notification rule, and sends a notification according to the first matching rule; the further check for matching conditions for the same build is not performed. You can reorder the configured notification rules.

The user rules are applied first, then the group rules are applied.

The group rules are processed in hierarchical order: starting from child groups to parent ones.

If there are more than one parent with their own rules set, the inherited rules are processed top-bottom corresponding to the order they are presented on the Notification Rules user profile tab (alphabetically).

Unsubscribing and Overriding Existing Rules

You may already have some notification rules configured by your System Administrator for the user group you're included in.

  • To unsubscribe from or override group notifications, add your own rule with the same watched builds and different notification events.

  • To unsubscribe from all events, add a rule with the corresponding watched builds and no events selected.

Customizing RSS Feed Notifications

TeamCity allows obtaining information about the finished builds or about the builds with the changes of particular users via RSS. You can customize the RSS feed from the TeamCity Tools sidebar of My Settings & Tools page using the Syndication Feed section (click customize to open the Feed URL Generator options) or from the home page of a build configuration. TeamCity produces a URL to the syndication feed on the basis of the values specified on the Feed URL Generator page.

Feed URL Generator Options



Select Build Configurations

List build configurations

Specify which build configurations to display in the Select build configurations or projects field. The following options are available:

  • With the external status enabled: if this option is selected, the next field shows the list of build configurations with the Enable status widget option set, and build configurations visible to everybody without authentication.

  • Available to the Guest user: Select this option to show the list of build configurations, which are visible to a user with the Guest permissions.

  • All: Select this option to show a complete list of build configurations; HTTP authorization is required. Selecting this option enables the "Feed authentication settings" field. If the external status for the build configuration is not enabled, the feed will be available only for authorized users.

Select build configurations or projects

Use this list to select the build configurations or projects you want to be informed about via a syndication feed.

Feed Entries Selection

Generate feed items for

Specify the events to trigger syndication feed generation. You can opt to select builds, changes or both.

Include builds

Specify the types of builds to be informed about:

  • All builds

  • Only successful

  • Only failed

Only builds with changes of the user

Select the user whose changes you want to be notified about. You can get a syndication feed about the changes of all users, yours only, or of a particular user from the list of users registered to the server.

Other Settings

The following options are available only if All is selected in the List build configurations section.

Feed Authentication Settings

Include credentials for HTTP authentication — check this box to specify the username and password for automatic authentication. If this option is not checked, you will have to enter your user name and password in the authorization dialog box of your feed reader.

TeamCity User, Password — configurable when the ... option is checked. Type the username and password which will be used for HTTP authorization.

Copy and Paste the URL into Your Feed Reader or Subscribe

This field displays the URL generated by TeamCity on the basis of the values specified above. You can either copy and paste it to your feed reader or click the Subscribe link.

Additional Supported URL Parameters

In addition to the URL parameters available in the Feed URL Generator, the following parameters are supported:

Parameter Name



A number; limits the number of items to return in a feed. Defaults to 100.


A negative number; specifies the number of minutes. Only builds finished within the specified number of minutes from the moment of feed request will be returned. Defaults to 5 days.


A name of the custom template used for rendering the feed (<template_name> ). The file <TeamCity Data Directory>\config\<template_name>.ftl should be present on the server. See the corresponding section on the file syntax.

By default, the feed is generated as an Atom feed. Add &feedType=rss_0.93 to the feed URL to get the feed in RSS 0.93 format.


Get builds from the TeamCity server located at http://teamcity.server:8111 address, from the build configuration with ID bt1, limit the builds to the those started with the last hour but no more than 200 items:

Last modified: 19 March 2021