Jira Snippet Library: JQL - Related Items

Rachel Wright

Sometimes you only know a small amount of information, like a keyword or a key phrase. Use a like search to find items containing those words.

Like examples

Use the tilde (~) symbol to perform a like keyword search.

• summary ~ "website"

• description ~ "website"

• comment ~ "website"

Use the text clause to search for keywords in an item’s summary, description, and comment at the same time.

• text ~ "website"

Linked items

I can never seem to remember the syntax for this search! I have to look this format up the most.

Find all items linked to a specific item.

• issue in linkedIssues(ITEM-1)

You can also query by the type of link in the format: issue in linkedIssues(ID, LinkType)

• issue in linkedIssues(ITEM-1, "relates to")

• issue in linkedIssues(ITEM-1, blocks)

• issue in linkedIssues(ITEM-1, duplicates)

• And more

Tip: Don’t forget to enclose any multi-work link types, like “relates to”, in quotes.

Labels

The labels field is tricky. The include query works as expected and returns any items that contain the specified label.

• labels = reimbursement

The exclude query needs an extra clause however. Be sure to add “OR labels is EMPTY” to also exclude items that do not have any labels.

• labels != reimbursement OR labels is EMPTY

---

Back to intro or article list