Configuring Notifications
TeamCity can notify users about various events:
in a web browser
via email
via Slack
in an IDE
This article explains how notifications work in TeamCity and shows how to set them up on your server.
Notification Levels
Notifications in TeamCity can be configured:
Notification rules are configured in the user profile settings. These rules can also be set at a user group level, so they are applied to all the users in the group. A user-level notification rule can be assigned to a specific project or multiple projects and build configurations. These notifications are available for IDEs, browsers, Slack, and email. | |
Requires configuring the Notifications build feature. Build-level notifications work best for notifying many people at once about events in a specific build configuration. You can specify 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. Currently, these notifications are available only for email and Slack. |
Configuring User-level Notifications
Email Notifications
TeamCity Email Notifier relies on the email address specified in your user profile.
To set up email notifications on a TeamCity server, the System Administrator needs to configure the SMTP server in Administration | Email Notifier. You can find the values of the expected parameters in you email server's settings.
Browser Notifications
TeamCity Browser Notifier can show notifications directly in your web browser. It works as a browser extension. See the details about it in this article.
Slack Notifications
TeamCity 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 here, or watch a video tutorial:
IDE Notifications
TeamCity IDE Notifier requires installing the TeamCity plugin in your IDE. For the details on installing TeamCity IDE plugins, refer to Installing Tools.
Configuring Build-level Notifications
To set up notifications on a build configuration level, you need to add the Notifications build feature to this build configuration. This feature has two types:
Email Notifier sends emails per events in this build configuration. Similarly to the user-level email notifications, it uses the SMTP server settings configured in Administration | Email Notifier.
Slack Notifier posts events to a selected Slack channel. Similarly to the user-level email notifications, requires configuring a connection to Slack.
Configuring Notification Rules
After you configure your preferred notification methods, it is time to choose which events will be triggering notifications.
For example, if the SMTP server is configured in Administration | Email Notifier, TeamCity will be sending emails according to the default rule: if a user has an email address added in their settings, TeamCity will email them whenever the build containing their changes fails.
Users can manage their own notification rules in their profile settings. Project Administrators can manage notification rules for a user or a user group in, respectively, Administration | Users | User's settings or Administration | Groups | Group's settings.
Read more about the composition and processing of notification rules in this article.
Changing Notification Templates
Project Administrators can change the default notifications' format by customizing their text templates. See the detailed instruction in this article.