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:

  • Display fields with the values of the request
  • Linked requests

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:
    • Display JQL - does the issue match the JQL condition?
    • Portal/Request type filter (JSM) - do the portal settings match?

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 JSM Portal Panels

JSM portal panels have additional considerations when testing:

  • Portal filter - ensure the correct portal is selected in context filters
  • Request type filter - verify the request type matches
  • Customer vs Agent view - portal panels are visible to customers; test from the customer portal if possible
  • Unlicensed access - JSM portal panels use unlicensedAccess, so the viewer doesn’t need a Jira license

Tips for testing JSM panels:

  1. Use Preview Panel with a service desk issue key to check the panel
  2. Verify the portal and request type filters match in Test Context
  3. Open the customer portal in a separate browser/incognito window to see the actual customer view

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 Display JQL
  • Understanding data format
  • Discovering available fields

Common Errors

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)

How to fix:

  1. Test the JQL in Jira’s Issue Navigator first
  2. Ensure custom field names match exactly (case-sensitive)

A Display JQL that fails hides the panel.


Debugging Tips

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

Linked Requests Not Shown

  1. Check that at least one link type is selected in Link types for filtering
  2. Check that the linked request is a Service Management request the customer may see: they are its reporter or a participant, or belong to an organization it is shared with
  3. Check the panel’s Actor - see Actor configuration

Next Steps