Docs · TraQL

Query language reference.

TraQL is a structured query language for work items. Field filters, parent/child links, date arithmetic, cross-project queries, aggregations, formatted text output.

Quick start

Open the Queries page from the sidebar. Type a query and press Cmd+Enter to run it.

Find open stories

type:story is:open

Count by status

SELECT count() GROUP BY state

Children of an epic

parent:STRI-42

Now-bucket standup list

SELECT format("- [{title}]({url})") WHERE bucket:now

Filter by any work item property. Fields support equality, comparison, negation, containment, and range operators.

type:story

Stories only

state:in_progress

In-progress items

assignee:Hannes

Assigned to Hannes

title:~"release planning"

Title contains text (case-insensitive)

id:300..310

ID range (inclusive)

Grammar Summary

query     = filter [ORDER BY sort_list]
          | SELECT func [GROUP BY field] [WHERE filter] [ORDER BY sort_list]

filter    = condition { (AND | OR) condition }
condition = NOT condition | "(" filter ")" | field_expr | match_expr | was_expr | changed_expr
field_expr= field ":" [operator] value

# Full-text search (ranked, stemming)
match_expr= "match" "(" terms ")"     # cross-field: title + description + comments
          | field ":?" value          # single field (title | description)

# History queries
was_expr     = field WAS value [BEFORE date] [AFTER date]
changed_expr = field CHANGED [FROM value TO value] [DURING range]

field     = word { "." word }        # e.g. state.count, release.shippedAt
operator  = "!" | "~" | "?" | ">" | ">=" | "<" | "<="   # ~ literal substring, ? ranked full-text
value     = word | quoted_string | word "|" word  | word ".." word | func
          | "empty"                  # null/empty check

func      = word "(" [args] ")"      # count(), last(7d), within(...)
sort_list = field [ASC|DESC] { "," field [ASC|DESC] }

# Shortcuts: is:open, is:closed, is:done, is:unassigned, is:stale, my:items
# Special values: none, me, active, current, open, future, closed, last, empty, all, today, now
# Link values: any, none, blocks, blocked_by
# Keywords: WAS, CHANGED, FROM, TO, BEFORE, AFTER, DURING

TraQL is read-only — it cannot modify work items.