Display Conditions

A JQL condition that controls when panels appear based on the data of the current request.


Display JQL Condition

Dynamic filter using JQL. Panel shows only when the current issue matches this query.

How It Works

The system runs the JQL query with the current issue and checks if it returns a match. This is evaluated for each issue view.

Basic Examples

priority in (Highest, High)
status = "In Progress"
labels = "important"

Combined Conditions

priority = High AND status != Done
duedate < now() AND status != Done
(priority = Highest OR labels = "urgent") AND status != Done

Error Handling

Display JQL (Fail-Close)

Display JQL uses fail-close behavior:

  • If JQL has syntax errors → panel hidden
  • If the query fails → panel hidden

Always test your JQL conditions before deploying: a broken query makes the panel disappear everywhere, not appear everywhere.


Common JQL Patterns

By Status

status = "To Do"
status in ("In Progress", "In Review")
status != Done
statusCategory = "In Progress"

By Priority

priority = Highest
priority in (High, Highest)
priority != Low

By Dates

duedate < now()
duedate <= endOfDay()
created >= -7d
updated >= -1d
created >= startOfMonth()

By Labels

labels = "needs-review"
labels in ("urgent", "escalated")
labels is EMPTY

By Components

component = "Backend"
component in ("API", "Database")
component is EMPTY

By Custom Fields

"Team" = "Engineering"
cf[10001] = "Value"
"Story Points" > 5

Troubleshooting

Panel Not Showing

  1. Test Display JQL in Issue Navigator - Add AND key = ISSUE-123 to test with specific issue
  2. Verify data exists - Check that fields you’re testing actually have values

Panel Showing Everywhere

You may have left the condition empty - an empty Display JQL places no restriction on visibility.

Panel Hidden Everywhere

A syntax error or a failed query hides the panel: Display JQL fails closed. Check the condition with Test Context and the JQL in the Issue Navigator.

Testing Display Conditions

Use the Preview Panel and Test Context features with a real issue key to test how your conditions evaluate. See Testing Panels for detailed instructions on testing display conditions.


Next Steps