User-created Custom Fields

This page explains how to access the value of User-created custom fields of different field types using Nunjucks. Each field's structure is explained, with examples. To understand how to write values into these fields see, Text input for fields and JSON input for fields.

It is now possible to access any user-created custom field of an issue by its Field name or ID. Click here to know how to find the ID of custom fields.

Example:

{{ issue.fields.Projectpicker.name }} and {{ issue.fields.customfield_10302.name }}, both return the name of the selected Project.

When the field name contains a space or any special character, you need to use the array syntax to access the field:

Example:

{{ issue.fields['Multi user picker'][0].displayName }}

Select list

Checkboxes / Multi-select list

Description: A field of the type Checkboxes/Multi-select list, is an array of objects. Each object represents an option of the checkbox/select list.

Structure:

Click here to see the structure of a field of Checkbox/Multi-select list type

Structure

"issue":
{
	...
	...
	"fields":
	{
		...
		...
		{
    		"self":String, //URL of the choice
    		"value":String, //Value of the choice
    		"id":String //ID of the choice
		},
		...
	}
	...
}

Example

"issue":
{
	...
	...
	"fields":
	{
		...
		...
		"customfield_10200":
		[
			{
				"self":"https://jmwe-test-2.atlassian.net/rest/api/2/customFieldOption/10100",
				"value":"Option1",
				"id":"10100"
			},
			{
				//Second option and so on..
			}
		],
		...
	}
	...
}

Accessing a field of Checkboxes/Multi-select list type:

The value of the last option:

{{ issue.fields['Multi-select field'] | last | field("value") }}

Display the values of all selected options, separated by a comma:
```
{{ issue.fields['Checkboxes field'] | join("," , "value") }}
```

Test whether a specific option is selected:

{{ issue.fields["Checkboxes field"] | find({"value":"Impediment"}) != null }}

Radio buttons / Single select list

Description: A field of Radio buttons/Single select list type is an object describing the selected option.

Structure:

Click here to see the structure of a field of Radio buttons/Single select list type

Structure

"issue":
{
	...
	...
	"fields":
	{
		...
		...
		"customfield_xxxx":
		{
    		"self":String, //URL of the choice
   			 "value":String, //Value of the choice
   			 "id":String //ID of the choice
		},
		...
	}
	...
}

Example

"issue":
{
	...
	...
	"fields":
	{
		...
		...
		"customfield_10203":
		{
			"self":"https://jmwe-test-2.atlassian.net/rest/api/2/customFieldOption/10103",
			"value":"Option2",
			"id":"10103"
		},
		...
	}
	...
}

Accessing a field of Radio buttons/Single select list type:
- The value of the option: {{ issue.fields['Single select field'].value }}

Cloud Migration Resources

User-created Custom Fields

Select list

Checkboxes / Multi-select list

Radio buttons / Single select list

Groups

Users

Versions

Text

Date/Time picker

Others