How to use custom fields in Automation rules

1 Advanced Issue Links Field
2 Multilevel Select Picker
- 2.1 Single select
- 2.2 Multi select
3 Multilevel Select Picker
4 Multilevel Select Picker (Multiple)

Advanced Issue Links Field

For using AIL field or populating the field in Automation rules the following format is used:

{
   "fields":{
      "customfield_id":{
         "issues":[
            {
               "label":"issueKey",
               "value":"issueKey"
            }
         ]
      }
   }
}

Customfield_id - ID of the custom field that is being used in the rule

label - Insert the issuekey of an issue that should populate the AIL field
value - Insert the issuekey of an issue that should populate the AIL field

Repeat the process for adding multiple issues in the field

{
   "fields":{
      "customfield_id":{
         "issues":[
            {
               "label":"issueKey",
               "value":"issueKey"
            },
            {
               "label":"issueKey",
               "value":"issueKey"
            }
         ]
      }
   }
}

Multilevel Select Picker

Single select

JSON format for the single select option:

Value - This is the ID of the option inside of the configuration. You can copy this ID by clicking on “Copy id” as seen on the screenshot below

Label - This is the “name” or label of the option

{
   "fields":{
      "customfield_10089":{
         "choice":[
            {
               "label":"Parent 1",
               "value":1676970224591,
               "children":[
                  {
                     "label":"Child 1",
                     "value":1676970238919,
                     "children":[
                        {
                           "label":"Child 1.1",
                           "value":1676970381270,
                           "children":[]
                        }
                     ]
                  }
               ]
            }
         ],
         "isMultiple":false
      }
   }
}

Multi select

JSON format for the multi select option:

Value - This is the ID of the option inside of the configuration. You can copy this ID by clicking on “Copy id” as seen on the screenshot below

Label - This is the “name” or label of the option

Multilevel Select Picker

Multilevel select picker can have only one parent therefore the JSON is a bit different.

Each option consists of two parts:

Value
Label

Value - This is the ID of the option inside of the configuration. You can copy this ID by clicking on “Copy id” as seen on the screenshot below

Label - This is the “name” or label of the option

Multilevel Select Picker (Multiple)

The correct JSON format for using the multilevel select picker field in Jira automation is the following:

On the left side is the JSON format for a multilevel select field and on the right side is the configuration of the field.

First section of the JSON is always the same except the field ID that is being utilized in the Automation rule.

Each multilevel select picker option has 4 parts to it:

Value
Label
Level
parentKey

Value - This is the ID of the option inside of the configuration. You can copy this ID by clicking on “Copy id” as seen on the screenshot below

Label - This is the “name” or label of the option

Level - This is the level of the field. Each option in the configuration has it’s level. For a parent this would be level 1, for it’s first child it would be level 2, child of level 2 would level 3, and so on…

parentKey - This is the key of the childs parent. This is the same as the Value mention above. One differnce here is it needs to be linked correctly to the childs parent. So in the case below for “Child 1.1” parentKey would be the ID(value) of the option “Parent 1”