Display Modules

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

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

  1. Go to Apps → Customer Portal Fields Panel settings
  2. Click the Module Settings tab
  3. Toggle modules on/off
  4. 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:

  1. Edit or create a configuration
  2. Find Display Module dropdown
  3. Select one module
  4. Save

Visibility Rules

A panel appears when ALL conditions are met:

  1. Module is enabled globally
  2. Configuration targets that module
  3. Portal matches (if specified)
  4. Request type matches (if specified)
  5. 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