YouTrack lets you customize your personal notification scheme. You can enable or disable specific notification channels and choose the changes you want to receive notification for. To access these settings, click your avatar, select the Profile link, then select the Notifications tab.
General Notification Scheme
The first section on this tab provides general settings that you can use to configure your notification scheme. The Send notifications to setting lets you choose which channels you want to use to receive notifications. The following options are available:
|Changes applied by me||Sends a notification any time you apply a change to any issue. This option is disabled by default, as you generally don't need to be notified about your own changes.|
|@mentions in issue descriptions and comments||Sends a notification any time you are mentioned by username in an issue description or comment.|
|Changes in a duplicate cluster||Sends a notification any time updates are applied to an issue that is part of a duplicate cluster that contains an issue you are watching.|
|Updates applied by the TeamCity integration||Sends a notification when a change is applied to an issue with a command that is entered in a comment in a VCS commit. This options is only supported when your YouTrack service has an active integration with TeamCity.|
|Failed commands from TeamCity||Sends a notification when a command that is entered in a comment in a VCS commit fails to update an issue. This options is only supported when your YouTrack service has an active integration with TeamCity.|
The Add Star tag on setting determines which actions automatically add you to the list of watchers for an issue. When enabled, these options automatically add the Star tag to an issue when you perform the corresponding action. You then receive notification according to the preferences you configure for your subscription to the Star tag. The following options are available:
|Vote||Adds you to the list of watchers when you vote for an issue.|
|Comment||Adds you to the list of watchers when you add a comment to an issue.|
|Update||Adds you to the list of watchers when you update an issue.|
With subscriptions, you can subscribe to updates for issues with specific tags or properties that match a saved search. For each subscription, you can select the events that trigger notifications. For specific examples, see Use Cases for Subscriptions.
The following default subscriptions are enabled for all users:
You are also automatically notified of any changes in issues that you are watching. This notification scheme is based on your subscription to issues with the following tag:
|Star||Sends a notification for all changes that are applied to issues that you have marked with the Star tag.|
The visibility of these subscription options is based on the access permissions that are available to your account and the tags that are stored in YouTrack.
You can update the notification scheme for these subscriptions at any time.
To manage an existing subscription:
- Click the Edit subscription icon.
- Enable the notification events you want to add or disable the notification options you want to ignore by selecting and deselecting the checkboxes that correspond with each event. For more information, see Subscription Events. To disable notifications for this subscription, you can either deselect all of the events that are currently enabled or click the Remove subscription button.
- Click the Save button.
To receive notifications for updates to issues with specific tags or properties that match a saved search, add a subscription to your profile.
To add a subscription:
- Click the New subscription button.
- Select an existing tag or saved search from the list. The list of tags and saved searches is filtered to show only tags and saved searches that you created yourself or have been shared with you. Use the input field to filter the list.
- Select the checkboxes that correspond with the events for which you want to receive notifications. For more information, see Subscription Events.
- Click the Save button.
Each subscription includes a list of issue events. These events generate a notification every time the corresponding action is applied to an issue that matches the subscription criteria.
The following events are available for tags:
|Updated||Sends a notification when an issue with this tag is updated.|
|Resolved||Sends a notification when an issue with this tag is resolved.|
|Commented||Sends a notification when a user adds a comment to an issue with this tag.|
|Voted||Sends a notification when a user votes for an issue with this tag.|
|Tagged||Sends a notification when a user adds this tag to an issue.|
|Untagged||Sends a notification when a user removes this tag from an issue.|
The following events are available for saved searches:
|Updated||Sends a notification when a user updates an issue that matches the saved search criteria.|
|Resolved||Sends a notification when an issue that matches the saved search criteria is resolved.|
|Commented||Sends a notification when a user adds a comment to an issue that matches the saved search criteria.|
|Voted||Sends a notification when a user votes for an issue that matches the saved search criteria.|
|Created||Sends a notification when a user creates an issue that matches the saved search criteria.|
Know your Notifications
When you enable several notification options and set up multiple subscriptions, your inbox may start to overflow. To keep your notifications in check, check the footer in the notification.
The default notification templates list the reasons for sending the notification in the message footer. If you start to receive notifications for updates that aren't that important, use the information in the message footer to determine which event triggered the notification and remove this event from your notification scheme. Click the Notification settings to access your profile and update your notification scheme.