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.
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. |
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.
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.
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:
TeamCity IDE Notifier requires installing the TeamCity plugin in your IDE. For the details on installing TeamCity IDE plugins, refer to Installing Tools.
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.
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.
Project Administrators can change the default notifications' format by customizing their text templates. See the detailed instruction in this article.
Thanks for your feedback!