What Quick Filters Do Back to top

A busy calendar shows everything its source query returns. A quick filter is a saved JQL condition — "My issues", "Blockers", "Unassigned" — that you switch on to narrow that calendar down to what you care about right now, and switch off again when you're done.

  • Filters belong to one calendar. Each calendar has its own set, and a filter only ever affects that calendar's issues.
  • Filters affect Jira issues only. Custom events are always shown, whatever is switched on.
  • Turning a filter on or off is personal. Two people looking at the same calendar can have different filters active.
  • Filters only remove issues from what you can already see — they never reveal anything Jira wouldn't show you anyway.
Calendar toolbar showing quick filter chips, with one chip outlined to mark it as active
Requires Jira. A quick filter is a JQL condition, so it only does something on calendars whose events come from Jira — a project, saved filter, or JQL source. Calendars that hold only custom events don't offer them.

Creating a Quick Filter Back to top

  1. In the sidebar, open the ⋮ menu next to a Jira-sourced calendar and choose Configure quick filters.
  2. Give the filter a name — this is the text on the chip, so keep it short.
  3. Write the JQL condition. With Jira connected you get the full JQL editor with field and value autocomplete; the query is checked against your Jira site as you type.
  4. Optionally tick "Visible to everyone who can see this calendar" to share it (see below).
  5. Click Create. The new filter is pinned to your chip bar, switched off.
Quick filters configuration dialog with a name field, a JQL condition editor, a share checkbox, and the list of existing filters

Conditions are ordinary JQL, so anything you can write in Jira works here:

  • assignee = currentUser() — my issues (personal for every viewer, without a filter each)
  • priority = Highest OR labels = escalation — the things that can't wait
  • status != Done AND duedate < endOfWeek() — due this week and still open
  • assignee IS EMPTY — unassigned work
You don't need to repeat the calendar's own query. A filter is added to the calendar's source, never used instead of it — a filter on a project calendar can't pull in issues from another project.

Applying Filters Back to top

Pinned filters appear as chips in the bar above the calendar, coloured to match the calendar they belong to. Click one to apply it; click again to switch it off. An applied chip is outlined. Hovering a chip shows its JQL, so you can check what it does without opening the dialog.

  • Several filters at once combine with OR. With "My issues" and "Blockers" both on, you see issues that match either — filters are alternative slices of the calendar, not a narrowing stack.
  • Filters on different calendars are independent. Each chip only narrows its own calendar; the others are untouched.
  • Hidden calendars hide their chips. Switch a calendar off in the sidebar and its filters leave the bar with it.
  • Your choices stick. Applied filters are remembered per person, so a calendar comes back the way you left it — on the hub and on space pages alike.

Pinning: the star

In the configuration dialog, the star next to each filter controls whether it gets a chip in your bar. Filters you create are starred automatically; a colleague's shared filter starts unstarred, so nobody's bar fills up with other people's presets. Un-starring a filter removes its chip and switches it off — a filter you can't see isn't left hiding issues.

Sharing & Ownership Back to top

  • A private filter (the default) is visible only to you.
  • A shared filter is visible to everyone who can see that calendar. Each of them still chooses whether to star it and whether to switch it on.
  • Only the creator can edit or delete a filter, even after sharing it and even for calendar administrators. Deleting a shared filter removes it for everyone using it, so the dialog asks first.

What you can do depends on your access to the calendar:

Your accessWhat you can do with quick filters
ViewSee shared filters, star them, switch them on and off for yourself
UseAll of the above, plus create filters — and edit or delete the ones you created
AdminSame as Use. Administering a calendar doesn't give you someone else's filter

Good to Know Back to top

  • Not in the page macro. A calendar embedded on a page shows what its author configured, without filter chips. Use the hub or a space page to filter.
  • Invalid JQL is caught when you save. If Jira rejects the condition, the dialog says so and the filter isn't stored — a broken filter can't quietly empty a calendar later.
  • Deleting a calendar deletes its filters. They're part of that calendar's configuration.
  • Read-only when unlicensed. If the subscription lapses, existing filters keep working and stay switchable; creating and editing them is disabled until it's renewed.

Need Help?

If you have questions or need assistance, our support team is here to help.

Contact Support