Category Custom Fields


Category Custom Fields are used to link Jira work items and Service Management Requests with Golive Categories. This article explains why to use them, how to create them, and how to configure and use them.



Why Use Category Custom Fields

Category Custom Fields allow teams to associate Jira work items with Golive Categories. This helps you track accurate statistics, such as the number of work items created, reproduced, or tested for specific Environment Categories.

Info

Category Custom Fields work similar to the Version concept in Jira. Like Versions, where multiple fields (e.g., Fix Version/s and Affects Version/s) use the same inventory, Category Custom Fields draw from a single list of Categories but can appear in multiple fields on the same issue.



Create a Category Custom Field

Requirements

You must have the Jira Administrator permission to create new custom fields from the Fields section.

Steps

  1. On the Jira Fields page, click Create new field.

  2. In the Field type field, select Apwide Golive Category.

  3. In the Name field, type the name of your new custom field, for instance “Category”.

  4. Click Create.

image-20260624-180833.png
Create a Category custom field

To make the Custom Field visible in work types, add it to your screens:



Update the Configuration of a Field

By default, all categories can be added to your Category Custom Fields. You can restrict to a maximum number of categories if needed.

Requirements

You must be a Jira Administrator.

Steps

  1. On the Jira Fields page, search for the field you want to configure.

  2. Next to the field, open the three-dots menu and click on Contexts and default values.

  3. For the relevant context, click Edit custom field config.

image-20260624-181209.png
Edit custom field configuration
image-20260624-181114.png
Category custom field configuration



Select Categories on the Issue Screen

Once you’ve configured a Category Custom Field and added it to a screen, you can easily select Categories directly from your work item in Jira.

Steps

  1. Open the Jira work item you want to edit.

  2. Locate the Category field.

  3. Search for and select one or more Categories.

Tip

To remove a Category, click the x icon next to it.

image-20260624-181436.png
Category custom field edition



Automation

To update Golive custom fields automatically, refer to our Jira Automation examples and our Rest API documentation.