• Products
  • Documentation
  • Resources

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 the following to your JQL query:

design[status] = "ready_for_development"

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-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.

 

Additional Help