Skip to main content

Notifications

Tramline sends notifications for every significant event in your release process to keep you and your team informed about an ongoing release. You can enable notifications in the Release Settings tab.

Enable notifications

Advanced configurationโ€‹

Not everyone in your team is the correct audience for all release-related notifications. Tramline allows you to configure which notifications you want, and what all channels do they need to go in the Notification Settings tab for each of your Release Settings.

This is the the exhaustive list of notifications you can configure:

NotificationDescription
Release ScheduledWhen a release is scheduled.
Release StartedWhen a new release is started.
Release StoppedWhen the release is stopped before finishing.
Release Finalize FailedWhen the release finalization fails.
Release EndedWhen the release finishes.
Release Health EventsWhen a release health event happens.
Backmerge FailedWhen the auto backmerge PR creation fails.
Build AvailableWhen a new build is generated.
Internal Release FinishedWhen an internal build step finishes.
Internal Release FailedWhen an internal build step fails.
Beta Release FailedWhen a release candidate step fails.
Beta Submission FinishedWhen a beta submission finishes.
RC FinishedWhen a release candidate finishes.
Internal Submission FinishedWhen an internal submission finishes.
Submission FailedWhen a submission fails.
Production Submission StartedWhen a production submission starts.
Production Submission In ReviewWhen a production submission is in review.
Production Submission ApprovedWhen a production submission is approved.
Production Submission RejectedWhen a production submission is rejected.
Production Submission CancelledWhen a production submission is cancelled.
Production Rollout StartedWhen a production rollout starts.
Production Rollout PausedWhen a production rollout is paused.
Production Rollout ResumedWhen a production rollout is resumed.
Production Rollout HaltedWhen a production rollout is halted.
Production Rollout UpdatedWhen a production rollout is updated.
Production Release FinishedWhen a production release finishes.
Workflow Run FailedWhen a workflow run fails.
Workflow Run HaltedWhen a workflow run is halted.
Workflow Run UnavailableWhen a workflow run is unavailable.
Workflow Trigger FailedWhen a workflow trigger fails.
tip

If you feel that your team doesn't require any notifications, as everyone is already informed through Tramline, you can deactivate all notifications in the Release Settings tab.

Custom contentโ€‹

note

This section is currently only relevant for Slack notifications.

Tramline offers adding custom input to each notification, so you can extend it to add additional links, tags users, tag groups, notify the channel and generally tune it to be more personalized. The custom content is appended to the main notification message.

Slack formatting inputSlack formatting output

Tagging usersโ€‹

To tag a user, you currently cannot just type their name as you would normally do in Slack, like @user. Instead, you need to type the user's Slack ID. You can find the Slack ID by clicking on the user's name in Slack and select copy ID from the context menu.

Slack User ProfileSlack User Copy Member ID

To tag a user, simply type out the user as follows: <@user-id>. For example, if you want to tag the user named kitallis with the Slack ID U0123456789 you would type <@U0123456789> and it would appear in the Slack message as @kitallis.

Tagging groupsโ€‹

Groups don't have the above limitation, you can simply type out the group name normally, like @group-name.

info

@here and @everyone will normally work as well, they don't need any special treatment.

Linking channelsโ€‹

Linking channels don't have any limitations, you can type out the channel name like #channel-name.

Adding hyperlinks to notifications can also be normally inserted by just pasting the link in the custom content input. It will get hyperlinked in the notification message.

Text formattingโ€‹

The following basic text formatting options are also directly supported:

FormattingDescription
*bold*Bold text
_italics_Italics
~strikethrough~Strikethrough
`code`Code block
```text```Multi-line code block

Formatting bulleted lists and numbered lists is not supported.