Set up Jira Cloud
Learn how to set up Jira Cloud and integrate it with other products and applications.
JQL design search
Add design properties to your Jira Query Language (JQL) queries to refine your issue search results. Advanced search makes it easy for your team to find and see updates to Jira issues 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 issue search, install and set up the free Figma for Jira app.
Design properties
You can search for issues based on their linked design properties:
design[status]
design[type]
design[lastUpdated]
design[totalCount]
For example, if you wanted to find issues 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 issues 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 issues 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 issues with designs updated within the last 8 hours.
design[lastUpdated] >= "2023-12-14" and design[lastUpdated] <= "2023-12-27"
Shows issues 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 issues that have 3 designs linked to them.
Was this helpful?
Still need help?
The Atlassian Community is here for you.