Insight Custom Field

To be able to report JIRA issues on Insight objects, you need to setup at least one Insight custom field.

Choose Single Select or Multi Select

The Insight custom field comes in two flavours, single select and multi select.

single select custom field is used when you want to restrict the possibility to associate only one Insight object to each JIRA issue. Configuring the Insight single select custom field will prevent users from associating more than one Insight object to each JIRA issue.

multi select custom field will allow the user to associate unlimited number of Insight objects to each JIRA issue.

Create the Insight custom field

  1. Login as a member of the jira-administrators group.
  2. Navigate to Custom Fields in the admin section of JIRA. 
  3. Click Add Custom Field and select Advanced
  4. Select the field type Insight Object (single select or multi select)
  5. Give your Insight Object Field a Name and a Description
  6. Associate the custom field to the desired screens


Configure the Insight custom field

To be able to configure the Insight Custom field, at least one of the two following conditions needs to be met:

  • You as a User, or one of the JIRA groups you belong to is configured as an Insight Administrator under Insight → Configure. Normally this is by default the JIRA Administrators group
  • You are a member of the JIRA System Administrators group

To configure the Insight Custom Field

  1. Locate your Insight custom field and click on the cog icon  and select Configure
  2. Click on the link "Edit Insight Configuration"
  3. Select which Object Schema the Insight custom field should use
    1. (info) Tip: You can create several Insight custom fields to use the same object schema or different object schemas
  4. Select the Object Type Root, this is the level in the Object Schema structure where you want the custom field to start at.
    1. Tick the box Include childs to enable selection of all objects under the Object Type Root, regardless of level. 
    2. By selecting "None" you enable the user to select any object in the selected Object Schema.

  5. You can restrict this custom field to just show JIRA User related objects. Logged in JIRA User will only see the objects where the User is related to. Insight fetches on User type, Group type and Email default type attributes. To restrict an object where a referenced object has a specific user connected (reference deep more the one), you can use an additional IQL. See bullet 8 below.
  6. You can restrict this custom field to just show project related objects. Users will only see the objects where the current project is related to.

  7. You can specify which reference types to be fetched. Leave this field blank to choose 'All reference types' if you want all reference types to apply.
  8. You can filter objects on attribute values to make the selection of objects to fit your specific needs. An example could be:

    Status = Active

    Read more about IQL here.

  9. You can show/hide this customfield on the customer details. This specific configuration may be removed in future releases when JIRA Service Desk has an open API to fetch this information, or third party custom field support.
  10. You can specify what kind of type (select, checkbox, radiobuttons) the custom field input should use.
  11. On multiple custom fields, you can specify if users should be able to click "Select all" button.
  12. In the create/edit view and in the customer portal, you can filter objects on attribute values additional to the IQL mentioned in bullet 8. This selection does not apply in any JQL search.

    An example could be:

    "System Owner".User = currentReporter()

    Read more about IQL here.


JIRA Service Desk configuration

Specify if you want the custom field to be shown on the customer portal issue view. Also if the Insight object picker should be available.


Configure attributes to show on JIRA view screen

To configure this, go to the Insight custom field configuration and open the "JIRA View" tab as shown:

Configure the create/edit view in custom fields

You can specify if you want to use the "Select" or "Radio Button" (Single) or "Checkbox" (Multi) when editing a custom field. The restriction is that if you have more or equal then 25 objects to select from, it will automatically use the "Select" type. "Select" is also set by default.

You can filter objects on attribute values additional to the general IQL filter mentioned in bullet 8 above.

On multiple custom fields, you can specify if users should be able to click "Select all" button.





On this page: