Customer Portal Fields Panel shows its panels in five places of the Jira Service Management customer portal request page.
Module Overview
Customer Portal Fields Panel registers 5 display modules. Each configuration targets exactly one of them.
| Module | Location |
|---|---|
| JSM Portal Panel | Request page, main column |
| JSM Portal Request Details Sidebar | Request page, right-hand details column |
| JSM Portal Header | Request page, above the page title |
| JSM Portal Subheader | Request page, below the page title |
| JSM Portal Footer | Request page, bottom |
Panels are shown on request pages only - not on the portal home page or on the request create form.
JSM Portal Modules
These modules display on the customer-facing Jira Service Management portal.
Portal Request Detail Panel
Location: Request details page in customer portal
Features:
- Visible to customers viewing their requests
- Shows alongside request details
Use for:
- Customer instructions
- SLA information
- Related articles or links
Portal Request Details Sidebar
Location: Right-hand details column of the request page, next to the request details
Features:
- Configured like any other panel
- Good for a short list of key fields of the request
- Panels that the Connect edition showed in the details sidebar are transferred to this location - see Moving from the Connect edition
Use for:
- Key fields of the request
- SLA of the request
Portal Header
Location: Request details page, above the page title
Features:
- The highest position available on the request page
- Renders on the request details page only
- Shows the name, description, display fields and link buttons of the panel
- Application (for JSM Portal) is not offered as its actor
Use for:
- A short note above the request title
- Link buttons to help resources
Portal Footer
Location: Request details page, bottom
Features:
- Renders on the request details page only
- Shows the name, description, display fields and link buttons of the panel
Use for:
- Contact information in the description
- Help links as link buttons
Portal Subheader
Location: Request details page, below the page title
Features:
- Prominent placement
- Renders on the request details page only
- Good for a few key fields right under the title
Use for:
- Key fields of the request, for example priority or an SLA
- Link buttons to related resources
Header, Subheader and Footer do not cover the whole portal. They are shown on the request page only - not on the portal home page, the request list, or the request create form. Customers who are not Jira users see a panel only when its Actor is Application (for JSM Portal), which is offered for every location except the Header. See JSM Integration.
Enabling Modules
Global Settings
- Go to Apps → Customer Portal Fields Panel settings
- Click the Module Settings tab
- Toggle modules on/off
- Click Save Settings
Disabled modules won’t display anywhere, even with configurations targeting them.
The page carries one toggle per display module - 5 in total, exactly the modules listed in Module Overview. Until the settings are saved for the first time, every module is on. A module switched off shows nothing and cannot be chosen in new configurations.
Per-Configuration
Each configuration specifies its display module:
- Edit or create a configuration
- Find Display Module dropdown
- Select one module
- Save
Visibility Rules
A panel appears when ALL conditions are met:
- Module is enabled globally
- Configuration targets that module
- Portal matches (if specified)
- Request type matches (if specified)
- Display JQL condition matches (if specified)
Example: Panel with:
- Module: JSM Portal Panel
- Portals: “IT Support”
- Display JQL:
status = "In Progress"
Shows on the request page only for IT Support requests with status “In Progress”.
Multiple Panels
Multiple configurations can target the same module. Here’s how they interact:
- Independence: Each panel loads its own data source and renders independently
- No limit: There is no hard limit on the number of panels per module, but performance degrades with many active panels
Next Steps
- Configuration Basics - Create panel configurations
- Context Filters - Control when panels appear
- JSM Integration - Detailed JSM setup
- Portal Panel Settings - Layout, link buttons, request fields on the portal

