Receiving Search Results via Email

Subscribing to a Filter

1. Choose Issues > Manage Filters.
2. A list of available filters is displayed:
   
   
   
3. Locate the filter you are interested in and click on its Subscribe link. The Filter Subscription form is displayed:
   
   
   
4. In the Recipients box, either choose 'Personal Subscription' (if you only wish to subscribe yourself), or select a group of recipients from the dropdown list.
   Note: You cannot select a group unless your JIRA administrator has granted you the 'Manage Group Filter Subscriptions' global permission.
5. Select one of the following types of schedule:
   
   • Daily — choose this if you want to receive one or more emails every day.
   • Days per Week — choose this if you want to receive one or more emails on particular days of every week.
   • Days per Month — choose this if you want to receive an email on a particular day of every month.
   • Advanced — see Advanced scheduling ('cron') below.
6. Click Subscribe.
7. You will now be shown a subscription summary page. If you wish, click Run now to test your subscription.

Advanced scheduling ('cron')

You can use a 'Cron Expression' to specify a custom schedule to suit your particular requirements.

Cron expressions consist of the following fields, separated by spaces:

The special characters operate as follows:

Here are some sample cron expressions:

Cron expressions are not case-sensitive

Subscription Context

Each time that a subscription is activated, the saved filter for the subscription is used to find the relevant issues. This search is executed for each user in the group that will receive the subscription email. This means that any filter that uses JQL function such as currentUser() will be evaluated with a different user each time. This also means that if one user doesn't have permission to see some of the issues returned by the search then the list of issues that they receive in email will be different from other users' email. This has two other consequences:

• If you share a subscription with a group with many members it can take a long time to generate the emails to be sent. This can make JIRA very slow for minutes. This is a good reason be careful with allowing the Manage Group Filter Subscriptions permission.
• If a group contains a user whose email address is actually a distribution list (i,e. a group email alias), then everyone on that distribution list will receive the same email, since JIRA doesn't know who the users on the list are. 

Managing Other User's Shared Filters

A shared filter is a filter whose creator has shared that filter with other users. Refer to Sharing a Filter for details. When a shared filter is created by a user, that user:

• Initially 'owns' the shared filter.
• Being the owner, can edit and modify the shared filter.

If you have the 'JIRA Administrators' global permission, you can manage shared filters that were created by other users.

To access the 'Shared Filters' feature:

1. Ensure that you are logged in as a user with the JIRA Administrators global permission.
2. On the top navigation bar, click the 'Issues' dropdown and select 'Shared Filters' from the list.
3. See Managing Shared Filters in the JIRA Administrator's Guide.