Notifications

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:

note

Global Settings

The administrator of your YouTrack instance enables email and Jabber notification at the global level. If a notification channel is disabled at the global level, you do not receive notifications, regardless of the personal settings in your profile.

Your administrator also determines whether notifications are sent on each issue change or collected and sent as a digest. For more information, see Notification Schemes.

The Notification events setting lets you choose which actions generate notifications. The following options are available:

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:

Subscriptions

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:

note

Star Tag

The Star tag is generated when you star an issue. If you don't see the Star tag in your list of default subscriptions, just star an issue and it appears automatically.

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:

1. Click the Edit subscription icon.

   • The Manage Subscription dialog opens.

     

2. 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.

3. Click the Save button.

   • The subscription is updated.

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:

1. Click the New subscription button.

   • The New Subscription dialog opens.

     

2. 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.

3. Select the checkboxes that correspond with the events for which you want to receive notifications. For more information, see Subscription Events.

4. Click the Save button.

   • The subscription is added to your profile.

Subscription Events

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:

The following events are available for saved searches:

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. Use this information to determine which events triggered the notification. If there are any events that you don't consider to be important, remove them from your notification scheme. There's a link in the footer that takes you straight to the Notifications tab.

Muted Threads

In each email notification that is sent by YouTrack, there is a link in the footer that you can use to mute notifications for a specific issue. Use this feature to stop receiving notifications for issues that generate too many email messages.

note

Notifications for User Mentions

Unless you disable the @mentions in issue descriptions and comments option in the general notification scheme, notifications for user mentions are still sent for muted issues.

The Muted threads section of the Notifications tab displays a list of issues for which you no longer subscribe to updates. To restore notifications for a specific issue, click the icon to unmute the thread.