Notification Settings

You can configure the email notification preferences in Release by adding events that trigger notifications and by modifying the recipients that receive the email notifications.

Note: The System Settings screen is reorganized to make the navigation more user-friendly. The settings are now grouped by theme, to easily locate and access the features.

Navigate to the upper-right corner of the screen, click > System Settings > Notifications.

Note: The Notifications settings page is available only for Administrators, who have the Admin global permission.

There are two types of default notification events:

• At task level
• At release level

For a more detailed description of the default notification events, refer to Notifications in Release.

For each notification event, you can add or remove the recipients that receive the email notifications.

• To remove a recipient from a notification event, click the x next to the recipient name.
• To add a new recipient, click in a row for a specific event, type the name of the recipient you want to add, and then click Enter.

The available email recipients are:

• Release Admin
• Task Owner
• Task Team
• Watcher

note

When only the task owner is set in the notifications settings screen for an event and there is no task owner set on a task, the email notifications are sent to the task team.

Add watchers on tasks

You can add yourself as a Watcher on tasks to receive email notifications when events occur on those tasks. To add other users as watchers on a task, you must have the edit task permission.

For more information on how to add a Watcher on a task, refer to Working with tasks.

Edit default notification message

To edit the default notification email for a specific event, click Edit Message for that event. You can customize the email template that will be sent when the notification event is triggered.

You can change the Subject and the body text of the email template.

note

You can style the body text in the email using HTML or Markdown. For more information, see Using Markdown in Release.

Based on the priority of the email notification, you can set any one one of the following values from the Priority drop-down list:

• High
• Normal
• Low

You can use these supported variables in the email template:

• $ {url} - the server URL provided in the configuration
• $ {release.*} - the release properties (the variable is available in release, task, and comment emails)
• $ {task.*} - the task properties (the variable is available in task and comment emails)
• $ {comment.*} - the comment properties (the variable is available in comment emails)
• $ {release.url} - the direct URL to the release
• $ {task.url} - the direct URL to the task
• $ {task.ownerFullName} - the full name of the task owner
• $ {task.descriptionHtml} - the task description that was processed by Markdown
• $ {task.dueInHours} - the number of hours until the task is due
• $ {task.dueInMinutes} - the number of minutes until the task is due
• $ {comment.authorFullName} - the full name of the author of the comment
• $ {comment.textHtml} - the comment text that was processed by Markdown

To open and view the email template in a new browser tab, click Preview email.

note

The task description is always included by default in the email template.

If you have made modifications to the email template and you want to revert to the latest saved changes, click Cancel.

Tip: You can add more customization to your notification templates using mustache. It used Markdown instead of HTML, and the Delimiter used is ${ instead of {{.

Important: If you are using Chrome web browser to open an email notification received for an event that occurred on a task or release and you click View task or View release, the browser redirects the http:// link to an https:// link and you will receive an error message. To fix this, manually replace https:// with http:// in the address bar. You can also go to chrome://net-internals and select HSTS, remove the Release domain name and then clear your browser cache.