- Panel Preview
- Context Preview
- Testing JSM Portal Panels
- Display Fields Preview
- Show issue JSON
- Common Errors
- Debugging Tips
- Next Steps
Panel Preview
Test with real issue data:
- Enter an Issue key (e.g., PROJ-123)
- Click Preview Panel
- 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:
- Enter an Issue key
- Click Test Context
- 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:
- Use Preview Panel with a service desk issue key to check the panel
- Verify the portal and request type filters match in Test Context
- 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:
- Select the display fields you want to show
- Enter an Issue key in the preview
- Click Preview Panel
- The display fields appear above the issue table with real data
Show issue JSON
View complete data structure:
- Open the Show issue JSON tab next to the preview
- Enter issue key
- Click Download Issue Data
- 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:
- Test the JQL in Jira’s Issue Navigator first
- Ensure custom field names match exactly (case-sensitive)
A Display JQL that fails hides the panel.
Debugging Tips
Panel Not Appearing
- Verify configuration is Enabled
- Check Context Filters match the test issue
- Ensure the Display Module is enabled globally
- Test Display JQL condition separately in Issue Navigator
- Use Test Context to check all conditions at once
Linked Requests Not Shown
- Check that at least one link type is selected in Link types for filtering
- 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
- Check the panel’s Actor - see Actor configuration
Next Steps
- Configuration Basics - Basic panel settings
- Bulk Operations - Export and import configurations
- Context Filters - Control when panels appear
- FAQ - Common issues and troubleshooting

