Learn how to configure Bundled Fields.
Before you start, log in as a user with Jira Administrators global permission.
Before you start configuring Bundled Fields, you need to add a dedicated custom field first. To learn more, go to Adding Bundled Fields.
To start configuring a Bundled Field custom field:
In the first configuration tab you can add and configure subfields of your future form. Scroll down to read descriptions of each option:
For Text Field (single line), you can define the formatting and validators. Read more about it here.
Add options to your select list.
Hide options. You may want to hide options to make the configuration view more clear. They won’t disappear from the list.
Additional settings for options include:
Remove options. Delete the options you no longer need. Tip: If you only want to reorder them, you can do it by drag and drop.
Required. Turn on the toggle to make a given subfield mandatory.
On the Customer Portal the anonymous or unlicensed Jira Service Management users won’t see the fields configured as Bundled Fields together with their subfields. When a subfield is configured as required, such users need to log in or sign up to submit the request form.
Fields set up as related shouldn’t be marked as required in global Jira settings. Otherwise, all Bundled Fields’ subfields would be recognized as required and you won’t be able to differentiate required subfields from optional ones.
If you’d like to make the entire custom field required, you can do so by setting up a minimum and maximum number of rows. For example, if you set up a minimum number of rows as 1 (or more), it will make it impossible to delete rows on the Create Issue screen and therefore practically make the custom field required.
Show label. Turn on the toggle to show the subfield’s label. This might be a good idea if you want your final form to be a table.
Additional settings for subfields include:
Adding a subfield description. Click on the three dots menu to get to this option. In a new window you’ll be able to add a field description that will show up right under the subfield in your final form.
Duplicating subfields. You can make a copy of the selected subfield, to easier configure another one. The duplicated subfield will be displayed right under the original one.
Deleting subfields. You can remove subfields you no longer need. Tip: If you only want to reorder them, you can do it by drag and drop.
Add a separator. You can divide your subfields into certain groups with a separating line. If you decide to give it a name, it will be integrated in the middle of the line on your final form.
You can change the separator’s position in the Layout editor.
Remember to always save the changes before leaving the configuration screen.
The second configuration tab lets you decide how the subfields will be displayed on your form. You can reorder them, change their size, or place short fields next to each other to save some space.
You can rearrange the fields simply by dragging and dropping them within the Layout editor tab:
When you drag and drop a field, it doesn’t automatically expand the form. If you’d like to put a field between two other fields, you’ll need to move them apart, so that there is enough white space between them.
Here’s what a Bundled Fields custom field may look like on the Create Issue screen:
Default layout:
Custom layout:
In the third tab you’ll be able to further improve your Bundled Fields. Scroll down to read the descriptions:
Bundle description. You can give your form a name or write a short description for the users. The text will appear right above the Bundled Field custom field in an issue.
How many groups. Define how many times your form can be displayed on the Create Issue and Edit Issue screens. There are three parameters available:
You can choose a maximum of 35 groups. If you select 0 as the Default number of groups, your Bundled Field will be generated as an empty state.
If you select 0 as the Min. number of groups and a user will remove all the groups on the Create Issue screen, all required subfields will be converted to optional.
New group button. Here you can change what’s written on the button for adding new groups. In other words, the button lets users multiply a group of subfields and provide a new set of data into subfields of the same type (for example, an alternative address).
To change the label, delete the default Add new group text and type in your own.
Layout on the Issue View. Here are all the available options for displaying Bundled Fields:
Custom Layout
Horizontal
Vertical
Display labels only for the first row. This option is particularly useful when you build a table with many rows. This way the label will only be displayed once, at the top of the column.
Display labels only for the first row. This option is particularly useful when you build a table with many rows. This way the label will only be displayed once, at the top of the column.
Remove labels from exports. Turn on the toggle to remove labels in Bundled Fields data exported to tables of the following formats:
The Printable view before and after turning on this option:
You may need to adjust your layout in the Layout editor in order to free some space for longer descriptions.
Result
A Bundled Field has been configured.
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.
