πŸ› οΈAdditional(Extension) Fields

πŸ› οΈAdditional(Extension) Fields

The Additional Fields feature allows admins to extend the Jira Service Management customer portal by adding any Jira custom field directly to the request detail view. This gives customers and agents instant access to critical information without navigating away from the ticket. Each field can have its own edit permission – read-only, agents only, or everyone – giving you full control over who can modify data.


πŸ—οΈ How to Configure Extension Fields

Step 1: Access Settings

Navigate to Projectβ†’ … β†’ Space settings

image-20260712-072534.png

Click Apps β†’ Extension JSM Portal

Click β†’ Fields Configuration tab.

Step 2: Add Jira Fields

  1. In the Add Jira Field to Portal search box, type a field name (e.g., "Priority", "Due Date", or any custom field)

    image-20260712-072825.png
  2. Select the field from the dropdown – it will be added to your configured fields list

πŸ’‘ Tip: Only fields not already added will appear in search results.

Step 3: Customize Each Field

✏️ Edit Display Label

  • Click directly on the field name text

  • Type your custom label (e.g., "Urgency Level" instead of "Priority")

  • Press Enter to save

πŸ”’ Set Edit Permission

Choose one of three permission levels per field:

Permission

Icon

Who Can Edit

Permission

Icon

Who Can Edit

πŸ”’ Read-only

πŸ”’

No one – view only

πŸ›‘οΈ Agents only

πŸ›‘οΈ

Licensed Jira agents only

✏️ Everyone

✏️

Any portal user (including customers)

Simply click the permission button to toggle between options.

πŸ”„ Reorder Fields

Use the β–² and β–Ό buttons to change the display order on the portal.

Step 4: Save Configuration

Click πŸ’Ύ Save Configuration to apply your changes.


πŸ–₯️ Using Extension Fields on the Portal

For Customers:

  1. Open any service request

  2. Scroll to the Extension Fields panel

  3. View all configured fields

    image-20260712-075952.png
  4. If you have permission, click any editable field (pencil icon appears on hover)

  5. Type your new value and click Save or press Enter

  6. Changes update instantly in Jira

For Agents:

  • Same experience as customers, but may have edit access to more fields

  • Fields marked "Agents only" display a πŸ”’ icon to customers but remain editable for agents


🧩 Supported Field Types

Field Type

Display

Edit Control

Field Type

Display

Edit Control

πŸ“ Text

Single-line input

Free text entry

πŸ“„ Textarea

Multi-line input

Free text entry

πŸ”’ Number

Number input

Validated numeric entry

πŸ“… Date

Date picker

Calendar selection

πŸ•’ DateTime

Date + time picker

Full timestamp selection

πŸ‘€ User

User name display

Typeahead search for Jira users

πŸ“‹ Select

Dropdown selection

Pick from predefined options

🏷️ Array/Multi-Select

Comma-separated values

Multiple selection

βœ… Checkbox

Checkbox display

Toggle on/off


πŸ’‘ Ready to Customize?

The Extension Fields feature puts the power of Jira's rich field ecosystem directly into your customer portal. Start adding, reordering, and configuring fields today to create a more informative and efficient service experience! πŸš€