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
- Test Display JQL in Issue Navigator - Add
AND key = ISSUE-123to test with specific issue - 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
- Context Filters - Portal and request type filters
- Testing Panels - Preview and debug display conditions

