JQL design search
Add design properties to your Jira Query Language (JQL) queries to refine your work item search results. Advanced search makes it easy for your team to find and see updates to Jira work items with designs linked to them. Learn more about using advanced search with JQL
Make sure Figma is connected
To see the latest design updates in your work item search, install and set up the free Figma for Jira app.
Design properties
You can search for work items based on their linked design properties:
design[status]design[type]design[lastUpdated]design[totalCount]
For example, if you wanted to find work items with designs marked ‘ready for development’, you would add design[status] = "ready_for_development" to your JQL query.
design[status]
Syntax | design[status] |
|---|---|
Field Type | TEXT |
Auto-complete | Yes |
Supported operators | =, != , IN, NOT IN |
Unsupported operators | ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
Supported functions | None |
You can add the following design status properties to your JQL queries:
design[status] = "ready_for_development"
design[status] = "none"
design[status] in (none)
design[status] != "ready_for_development"
Add an exclamation mark (!) to your query to search for work items that do not have designs marked as ‘ready for development’.
design[status] = "ready_for_development" AND Sprint not in (openSprints(), futureSprints()) AND status != Closed
Extend your query to search for work items with designs marked as ‘ready for development’ that are still in the backlog.
design[type]
Syntax | design[type] |
|---|---|
Field Type | TEXT |
Auto-complete | Yes |
Supported operators | =, != , IN, NOT IN |
Unsupported operators | ~, !~, >, >=, <, <=, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
Supported functions | None |
You can add the following design type properties to your JQL queries:
design[type] = "node"
Looks for an individual element in a design.
design[type] = "group"
Looks for a collection of nodes in a design, like a Figma section or group.
design[type] = "canvas"
Looks for the workspace that houses the nodes and groups, like a Figma page.
design[type] = "file"
Looks for a file that contains all nodes, groups, and canvases.
design[type] = "other"
Looks for design types that are not mentioned above.
design[type] in ("node", "group")
Looks for designs that fit multiple types.
design[type] not in ("file", "canvas", "other")
Excludes certain design types from your search.
design[lastUpdated]
Syntax | design[lastUpdated] |
|---|---|
Field Type | DATE |
Auto-complete | No |
Supported operators | > , >= , < , <= |
Unsupported operators | ~, !~, =, != , IN, NOT IN, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
Supported functions | None |
Examples
design[lastUpdated] >= -8h
Shows work items with designs updated within the last 8 hours.
design[lastUpdated] >= "2023-12-14" and design[lastUpdated] <= "2023-12-27"
Shows work items with designs updated between December 14 to 27, 2023.
design[totalCount]
Syntax | design[totalCount] |
|---|---|
Field Type | NUMBER |
Auto-complete | No |
Supported operators | =, > , >= , < , <= |
Unsupported operators | ~, !~, != , IN, NOT IN, IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
Supported functions | None |
Example
design[totalCount] = 3
Shows work items that have 3 designs linked to them.
Was this helpful?