Read-only Insight custom field

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

The readonly custom field allows you to include information about objects in your issues, without being able to change this information, as it's read only.


An example is an employee off-boarding – you can use this field to display the employee's current assets on the off-boarding issue, so you know what needs to be collected before they leave.

Creating a read-only custom field

  1. Log in as the Jira administrator.
  2. Go to Administration > Custom fields.
  3. Click Add custom field, and select Advanced.
  4. Search for Insight Object/s, and select it.
  5. Enter a name and description for your field.
  6. Associate the custom field with desired screens in Jira.

Configuring the read-only custom field

With your custom field created and associated with the right screens in Jira, you can now configure how it will behave.

  1. Find your custom field on the Custom fields page, and click Configure next to it.
  2. Select Edit Insight Configuration.
  3. Select which object schema the custom field should use.
  4. Configure other settings. You can check what they mean in the table below.

Object schemaObject schema that the custom field should use. If you want this field to refer to specific objects, make sure you point to the right schema.
Filter scope (IQL)

This is the "core" scope for this field. Any searching in Jira (JQL) will apply to this IQL.

objectType = "Computer"
Filter assign scope (IQL)

Allows you to automatically set objects to the custom field. This can be filtered on any issue field values with support for placeholders.

//Assign objects depending on the reporter
Location.Employee = currentReporter()
//Can be specified like this as well due to support for place holders
Location.Employee = ${reporter}
User interaction
Object attributes on issue view

You can specify the attributes that should be shown on any object attached to an issue in the Jira issue view.

Enabling access for customers

When you add Insight custom fields to Jira Service Management, you need to enable them for customer portals. Without these steps, customers won't be able to access these fields. Learn more...

Last modified on Oct 19, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.