Testing Panels

Panel Preview

Test with real issue data:

  1. Enter an Issue key (e.g., PROJ-123)
  2. Click Preview Panel
  3. View rendered result

The preview shows exactly how the panel will appear on the issue, including:

  • Applied templates with actual data
  • JQL query results

JQL Parameter Preview

For panels using parametric JQL (JQL with template variables), use the Test JQL feature to verify the query resolves correctly.

How to test:

  1. Enter an Issue key in the preview field
  2. Click Test JQL
  3. The template variables are replaced with real values from the specified issue
  4. The resolved JQL is shown along with the number of matching issues

Example:

Your JQL template:

"Epic Link" = {{ issue.key }} AND status != Done

With issue key PROJ-100, resolves to:

"Epic Link" = PROJ-100 AND status != Done

The result shows how many issues match and whether the JQL is valid.

Tip: If the resolved JQL returns 0 results, verify the issue has the expected relationships or data.


Context Preview

The Test Context feature checks all filter conditions for a specific issue to determine whether a panel would be visible.

How to test:

  1. Enter an Issue key
  2. Click Test Context
  3. View results for each filter condition:
    • Project filter - does the issue’s project match?
    • Issue type filter - does the issue type match?
    • Display JQL - does the issue match the JQL condition?

Each condition shows a pass/fail status, making it easy to identify which filter is preventing a panel from appearing.

Tip: If all conditions pass but the panel still doesn’t show, verify the display module is enabled in Module Settings.


Testing Display Conditions

Display conditions use template syntax to conditionally show or hide panels. To test them:

  1. Configure a Display Condition using template syntax (see Display Conditions)
  2. Enter a test Issue key in the preview
  3. Click Preview Panel - the preview respects display conditions
  4. If the condition evaluates to false, the preview shows that the panel would be hidden

Testing tips:

  • Start with a simple condition and build up complexity
  • Use the Show issue JSON tab to verify field values before writing conditions
  • Test with multiple issues to verify both the “show” and “hide” cases
  • Remember that display conditions fail closed - if the template has an error, the panel is hidden

Display Fields Preview

When configuring Display Fields (fields from the current issue shown above the table), you can preview how they render:

  1. Select the display fields you want to show
  2. Enter an Issue key in the preview
  3. Click Preview Panel
  4. The display fields appear above the issue table with real data

Show issue JSON

View complete data structure:

  1. Open the Show issue JSON tab next to the preview
  2. Enter issue key
  3. Click Download Issue Data
  4. Explore available fields

Useful for:

  • Finding field IDs for templates
  • Understanding data format
  • Discovering available fields
  • Debugging template expressions

Template Syntax Guide

Quick reference panel with:

  • Variable syntax
  • Condition examples
  • Loop patterns
  • Filter functions

Access the syntax guide directly from the configuration editor for quick reference while building templates.


Common Errors

Template Syntax Errors

When a template has a syntax error, the panel displays an error message instead of the rendered content.

Common causes:

  • Missing closing tags: {% if ... %} without {% endif %}
  • Typo in variable name: {{ isue.key }} instead of {{ issue.key }}
  • Invalid filter: {{ value | nonexistentFilter }}
  • Unclosed string: {% if status == "Open %}

How to fix:

  1. Check the error message - it typically includes the line number and description
  2. Use the Template Syntax Guide panel for correct syntax
  3. Start with a minimal template and add complexity incrementally
  4. Use Preview Panel after each change to catch errors early

JQL Errors

JQL errors appear when the query syntax is invalid or references nonexistent fields.

Common causes:

  • Referencing a custom field that doesn’t exist: "Custom Field Name" = value
  • Invalid JQL function: status = inProgress() (not a valid function)
  • Parametric JQL where the template variable resolves to an empty value

How to fix:

  1. Test the JQL in Jira’s Issue Navigator first
  2. For parametric JQL, use Test JQL to see the resolved query
  3. Ensure custom field names match exactly (case-sensitive)
  4. Check that template variables have | default fallbacks for potentially empty values

Display Condition Errors

Display conditions use the same template engine as descriptions and JQL queries. Errors in display conditions cause the condition to fail closed - the panel is hidden. The same applies to Display JQL: a query that fails hides the panel.

How to fix:

  1. Use Test Context to check the condition evaluation
  2. Verify the condition returns a truthy/falsy value
  3. Test the condition in the description first to debug, then move it to the display condition field

Debugging Tips

Template Not Rendering

  1. Check template syntax - use the Template Syntax Guide tab
  2. Verify field names match the data from Show issue JSON
  3. Test with a simple template first: {{ issue.key }}

Panel Not Appearing

  1. Verify configuration is Enabled
  2. Check Context Filters match the test issue
  3. Ensure the Display Module is enabled globally
  4. Test Display JQL condition separately in Issue Navigator
  5. Use Test Context to check all conditions at once

JQL Query Returns No Results

  1. Test the JQL in Issue Navigator first
  2. Use Test JQL to see the resolved parametric query
  3. Verify linked issues exist if using link-based queries
  4. Check that the executing user has permission to see the target issues

Next Steps