YouTrack Standalone 2017.3 Help

Notifications

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.

profile 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:

OptionDescription
EmailEnables notification by email for your user account. Notifications are sent to the email address that is saved in your Hub profile. This option is only supported when email notifications are enabled at the global level for your YouTrack service.

When enabled, you have the option to receive email messages in HTML or plain text.

JabberEnables notification over Jabber for your user account. Notifications are sent to the Jabber account that is saved in your Hub profile. This option is only supported when Jabber notifications are enabled at the global level for your YouTrack service.

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

OptionDescription
Changes applied by meSends 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 commentsSends a notification any time you are mentioned by username in an issue description or comment.
Changes in a duplicate clusterSends 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 integrationSends 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 TeamCitySends 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:

OptionDescription
VoteAdds you to the list of watchers when you vote for an issue.
CommentAdds you to the list of watchers when you add a comment to an issue.
UpdateAdds you to the list of watchers when you update an issue.

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.

profile subscriptions

The following default subscriptions are enabled for all users:

Saved SearchDescription
Assigned to meSends a notification for all changes that are applied to issues for which you are set as the Assignee.
Reported by meSends a notification for all changes that are applied to issues that you reported.
Commented by meSends a notification for all changes that are made to issues that you have added a comment to.
Unassigned in [Project Name]Sends a notification for any unassigned issues that are created in your project. This saved search is generated automatically when you create a project and are set as the project lead. To let other members of your team enable and use this notification scheme, share the saved search. If you delete the saved search, the notification scheme is disabled.

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:

TagDescription
StarSends 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:

  1. Click the Edit subscription icon.
    • The Manage Subscription dialog opens.
      manage subscription
  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.
      new subscription
  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:

EventDescription
UpdatedSends a notification when an issue with this tag is updated.
ResolvedSends a notification when an issue with this tag is resolved.
CommentedSends a notification when a user adds a comment to an issue with this tag.
VotedSends a notification when a user votes for an issue with this tag.
TaggedSends a notification when a user adds this tag to an issue.
UntaggedSends a notification when a user removes this tag from an issue.

The following events are available for saved searches:

EventDescription
UpdatedSends a notification when a user updates an issue that matches the saved search criteria.
ResolvedSends a notification when an issue that matches the saved search criteria is resolved.
CommentedSends a notification when a user adds a comment to an issue that matches the saved search criteria.
VotedSends a notification when a user votes for an issue that matches the saved search criteria.
CreatedSends 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.

notification email

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.

Last modified: 17 November 2017