Jira Snippet Library: JQL - For Boards

Rachel Wright

Board Queries and Subqueries

A board is a status-based view of items. Items on a board are determined by one main JQL query. Items can be further organized using optional swimlane queries or quick filter subqueries.

• A swimlane is a horizontal grouping of items on a board.

• A quick filter is a one-click segmenting function on a board.

Example 1

Purpose: A board showing incomplete work segmented by priority using swimlanes.

• Main board query

  • project = KEY and statusCategory != Done

• Swimlane subqueries

  • priority in (Highest, High)

  • priority in (Medium)

  • Everything else (A board default)

Example 2

Purpose: A board showing unprioritized work for the company website, filtered by component, using quick filters.

• Main board query

  • project = KEY and status = Backlog

• Quick filter subqueries

  • component = “Copy change”

  • component = “Image change”

  • component = “Nav change”

  • component = “Code change”

Additional Quick Filters

Some additional common quick filter queries are:

• Items assigned to the current user

  • assignee = currentUser()

• Items reported or created by the current user

  • reporter = currentUser() or creator = currentUser()

• Items updated in the last day

  • updated >= -1d

• Items created this week

  • created >= startOfWeek()

 

---

Back to intro or article list