Saved filters & digests

Saving a filter

Run a search in the issue list (basic or JQL) and press Save current filter. Give it a name and save. The filter appears in your Saved Filters and under Filters → Saved filters. A filter stores the query only; to also keep the layout, grouping and columns, make a view.

Managing filters

Filters → Saved filters has two lists: My filters and Shared with me. Use New filter to type a query directly under Query. For each of your filters you can edit, share, subscribe (the envelope) or delete. Mark a filter as a favourite to keep it near the top.

Sharing

Press Share (the share icon), then Share with: a user, a group (you must belong to it), a project (its members), or everyone who can sign in. Only the owner can change a filter or its sharing. A shared filter runs as the person using it, so it never reveals issues they cannot see — and currentUser() means them, not you.

Subscriptions and digests

A subscription e-mails you the current result of a filter on a schedule — a morning digest of new bugs, a Monday list of overdue work.

1. On Saved filters, press the envelope (Email me this filter on a schedule).
2. Choose Every day or Every week (then the weekday) and the hour.
3. Decide what happens when the filter returns nothing: skip the e-mail or send it anyway.
4. Save. Use Unsubscribe in the same dialog to stop.

You can subscribe to filters shared with you, not just your own. Each person has their own subscription.

Where filters are used

• Boards — a board shows the issues of its filter; Quick filters add one-click narrowing on top.
• Dashboards — gadgets such as filter results and pie charts read a filter.
• Plans — a filter can be a plan source.
• Automation — a rule’s JQL condition can use the same syntax.

Because they all use the same language, a query that works in one place works in the others — see the JQL reference.