logoBack to App page
Extension for Jira Service Management
Cloud Data Center
Documentation
FAQ
Release notes
Migration path
Integration
Extension for Jira Service Management
Cloud Data Center
Documentation
FAQ
Release notes
Migration path
Integration
Last updated Dec 20, 2025

Add Dynamic Fields

Learn about configuring Dynamic Fields for particular request types.

Adding Dynamic Fields to a selected request form means turning this request form into the form that adjusts its content in response to the user’s input. Defining dynamic behavior of fields can be done with the Conditions and Validators configuration.

You can configure a single request form so that it adapts its content to different cases with fields appearing dynamically. As a result, the process of raising requests on the Customer Portal becomes shorter and more straightforward, while service desk agents receive precise information they need.

Info

Due to ongoing platform improvements, certain views presented in documentation may not fully reflect the latest in-app changes. We’re actively updating our content to match the new experience.

Watch the full configuration walkthrough

Configuration

The Customer form extension section in Space settings allows you to set configuration for the fields of a particular request type. The configuration view is divided into two areas: Fields Defined in Request Type and Dynamic Fields.

Info

To configure Fields Defined in Request Type, go to the Request type section in Jira Space settings. To read more, see Atlassian documentation.

Quick Guide

Steps

  1. Select a request type which you want to make dynamic.
  2. Go to the Dynamic Fields section and select a field from the list. You can also start typing the field’s name to see hints. If you don’t see a particular field on the list, use the Manage fields button to add all the necessary fields.
Info

By adding fields in the Dynamic Fields section, bear in mind that:

  • in order to add the Assets objects custom field and use Assets in Jira Service Management it’s required to upgrade to the Premium Plan and establish your connection with the Assets API. To learn more, navigate to the Dynamic Fields with Assets section.
  • the External assets platform fields are supported without filtering, meaning that currently you can display all assets in a Dynamic Form. For more information on asset management in Jira Service Management, see Atlassian documentation.
  1. In Display name you can type a custom field name that will be visible to the Customer Portal users.
  2. In Field help you can provide a short description that will simplify filling in the field to the Customer Portal users.
Tip

You can use Markdown in Field help. Your Field help can include the following elements: Headers, Links, Images, Horizontal Rule, Footnotes, Tables, Emphasis and Lists. Bear in mind that currently, it’s not possible to use: Code and Syntax Highlighting, Inline HTML, YouTube Videos, Blockquotes and Line Breaks.

  1. Once you’ve added the help text, you can choose how it appears with Show help as icon. It’s possible to display the text below the field or as an info tooltip icon.
Show help as icon
Show help as icon

When the Show help as icon is enabled, the help text appears as a small info icon that users can click to read the description. This keeps your form clean and organized while still making important guidance easy to find.

Show help as icon on Portal
Show help as icon on Portal

Result

The added field is displayed in the Dynamic Fields section.

Next steps

Configure Conditions and Validators to set rules that make the fields appear dynamically on the request form.

Dynamic Forms display

In a request form, Dynamic Fields are displayed below non-dynamic fields defined in the request type.

Tip

Use drag-and-drop to modify the order of Dynamic Fields. Note that the order of non-dynamic fields which are defined in request type can’t be changed.

To learn details about displaying Dynamic Fields in Request Form and Issue View, navigate to the Display Dynamic Fields.

Info

Before you start using Dynamic Fields on the request form, consider the following:

  • the size limit for attachment files in a dynamically displayed Attachment field is 512MB. You can’t add multiple attachment files if their total size is larger than 512MB, or a single attachment file of size exceeding the limit.
  • by filling in the User Picker (single user) and User Picker (multiple users) fields, you can search and select relevant users from the drop-down list. Note that Jira Service Management customers can search only for other unlicensed users. All the Jira users need the Browse Users and Groups global permissions granted for unrestricted search results. For more information about global permissions, see Atlassian documentation.
  • don’t delete the atlassian-addons-project-access project role either from project, or global permissions as it’s necessary to ensure that Extension for Jira Service Management runs smoothly.

Deleting configuration

To remove a field added to the Dynamic Fields section, click on the Bin icon which is displayed next to the field on hover.

You can also delete several fields at once by unselecting them in Manage fields.

Summary field in Dynamic Form

Due to current Jira Cloud limitations, you can add a Summary field to a Dynamic Form only if it is set as hidden. Moreover, it is necessary to refresh the page after raising a request to see the submitted Summary.

Steps

To add the Summary field as Dynamic Field for a selected request type:

  1. In Space settings > Request types, click the selected request type.
    Editing request types
    Editing request types
  2. Go to Request form.
    Request form
    Request form
  3. Unfold the Summary field section and select Use preset value and hide from portal.
    Request form
    Request form
  4. Provide a preset value and click Save changes.
    Extension for Jira Service Management -
    Extension for Jira Service Management -
    Note
    Once a reporter raises a request by using the request form with the Summary field as dynamic, they will first see the preset value as their request summary. It is necessary to refresh the page to see the submitted summary.
  5. Open the configured Request Type in Space settings > Apps > Extension for Jira Service Management > Customer form extension and add Summary to Dynamic Fields.
    Tip
    You can add Summary to Dynamic Fields by clicking either Manage fields or Add a new field.
    Extension for Jira Service Management -
    Extension for Jira Service Management -

Result

The Summary field is added to Dynamic Fields. You can now configure Validators for it.

Summary dynamic field is added
Summary dynamic field is added

Example

A request form with the Summary field displayed at the bottom of the form as dynamic.

Request form with Summary dynamic field added
Request form with Summary dynamic field added

Once a request is raised through a form with the Summary field as dynamic, the reporter sees the configured Summary preset value as their request summary.

Request form with Summary dynamic field added
Request form with Summary dynamic field added

It is necessary to refresh the page to see the submitted Summary. The update of the Summary may take a few moments.

Request form with Summary dynamic field added
Request form with Summary dynamic field added

Need help?

If you can’t find the answer you need in our documentation, raise a support request. Include as much information as possible to help our support team resolve your issue faster.