---
title: "User-created Custom Fields"
canonical: "https://support.appfire.com/space/JMWEC/465505179/User-created%20Custom%20Fields"
format: markdown
---
> Macro (aura-html)

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, <span style="color: #000000">[Text input for fields](https://appfire.atlassian.net/wiki/spaces/JMWEC/pages/466289528)</span><span style="color: #000000"> and </span><span style="color: #000000">[JSON input for fields](https://appfire.atlassian.net/wiki/spaces/JMWEC/pages/466225769)</span><span style="color: #000000">.</span>

> ⚠️ It is now possible to access any user-created custom field of an issue by its *Field name* or *ID*. Click [here](https://confluence.atlassian.com/jirakb/how-to-find-id-for-custom-field-s-744522503.html) 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

> Macro (panel)
> 
> #### <span style="color: #000000">Checkboxes / Multi-select list</span>  
> 
> 
> - **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**:
>   
> - **Accessing a field of Checkboxes/Multi-select list type**:
>   - The value of the last option:
>     
>   - Display the values of all selected options, separated by a comma:
>     
>     
>     
>     
>     
>     
>   - Test whether a specific option is selected:

  


> Macro (panel)
> 
> #### <span style="color: #000000">Radio buttons / Single select list</span>
> 
> - **Description**: A field of *Radio buttons/Single select list* type is an object describing the selected option.
> - **Structure**:
>   
> - **Accessing a field of Radio buttons/Single select list type**:
>   - The value of the option: `{{ issue.fields['Single select field'].value }}`

  


> Macro (panel)
> 
> #### <span style="color: #000000">Cascading</span>  
> 
> 
> - **Description**: A field of *Cascading type* is an object representing parent of the cascading with one field:
>   - `child`, an object representing the child of the parent.
> - **Structure**:
>   
> - **Accessing a field of Cascading type**:
>   - The value of the parent of the cascading field: `{{ issue.fields["Cascading field"] }}`
>   - The value of the child of the cascading field: `{{ issue.fields["Cascading field"] | field("child.value) }}`
>   - Display the parent and child of the cascading field values separated by a comma:

### Groups

> Macro (panel)
> 
> #### <span style="color: #000000">Single Group Picker</span>  
> 
> 
> - **Description**: A field of *Single group picker* type is an object that represents the selected group
> - **Structure**:
>   
> - **Accessing a field of Single Group picker type: **
>   - Name of the group: `{{ issue.fields['Single group picker field'].name }}`
>   - ID of the group: `{{ issue.fields['Single group picker field'].groupId }}`

  


> Macro (panel)
> 
> #### <span style="color: #000000">Multi-Group Picker</span>
> 
> - **Description**: A field of *Multi-group picker* type is an array of objects. Each object represents a single group.
> - **Structure**:
>   
> - **Accessing a field of Multi-group picker type**:
>   - Name of the first group:
>     
>   - ID of the first group:

### Users

> Macro (panel)
> 
> #### <span style="color: #000000">Single User picker</span>
> 
> - **Description**: A field of *Single user picker* type field is an object that represents the selected user.
> - **Structure**:
>   
> - **Accessing a field of Single user picker type**:
>   - Display name of the user: `{{ issue.fields['Single user type field'].displayName }}`

  


> Macro (panel)
> 
> #### <span style="color: #000000">Multi-user picker</span>  
> 
> 
> - **Description**: A field of *Multi-user picker type* is an array of objects. Each object represents a single user.
> - **Structure**:
>   
> - **Accessing a field of multi-user type**:
>   - Display the users' *username* separated by a comma: `{{ issue.fields['Multi user type field'] | join("," , "accountId") }}`

### Versions

> Macro (panel)
> 
> #### <span style="color: #000000">Single version picker</span>
> 
> - **Description**: A field of *Single version picker* type is an object that represents a single selected version.
> - **Structure**:
>   
> - **Accessing a field of Single Version picker type**:
>   - Name of the version: `{{ issue.fields['Single version picker field'].name }}`

  


> Macro (panel)
> 
> #### <span style="color: #000000">Multi-version picker</span>
> 
> - Description: A field of *Multi version picker type* is an array of objects. Each object represents a single version.
> - **Structure**:
>   
> - **Accessing a field of Multi version picker type**:
>   - First version name: `{{issue.fields['Multi version picker type field'].name}}`
>   - Last version name:
>     '|' is the pipe operator and 'last' is the filter. See [Nunjucks](https://appfire.atlassian.net/wiki/spaces/JMWEC/pages/465503811) annotations for more filters.
>   - Join <span style="color: #000000">the </span>*names*<span style="color: #000000"> of the version/s, separated by commas: </span>`{{issue.fields['Multi version picker type field'] | join("," , "name")}}`

### Text

> Macro (panel)
> 
> #### <span style="color: #000000">Single-line text field type</span>
> 
> - **Description**: A field of *Single line text type* is a string representation of a single-line text describing the text field.
> - **Structure**:
>   
> - **Accessing a field of Single-line text field type**:
>   - The text of the field: `{{ issue.fields['Single line text field'] }}`

  


> Macro (panel)
> 
> #### <span style="color: #000000">Multi-line text field type</span>
> 
> - **Description**: A field of *Multi-line text type* is a string representation of a multi-line text describing the read-only text.is a string that represents a multi-line text.
> - **Structure**:
>   
> - **Accessing a field of Multi-line text field type**:
>   - The text of the field: `{{ issue.fields['Multi line text'] }}`

### Date/Time picker

> Macro (panel)
> 
> #### <span style="color: #000000">Date picker type field</span>
> 
> - **Description:** A field of *Date picker type* is a String representing the date in [ISO_8601](https://en.wikipedia.org/wiki/ISO_8601) format.
> - **Structure**:
>   
> - **Accessing a field of Date picker type: **
>   - The value of the Date picker field:`{{ issue.fields['DP'] }}`
> 
> > ⚠️ You can use the [date](https://appfire.atlassian.net/wiki/spaces/JMWEC/pages/466323491) filter to manipulate and/or format the value

  


> Macro (panel)
> 
> #### <span style="color: #000000">Date time picker type field</span>
> 
> - **Description:** A field of *Date time picker type* is a String representing the date in [ISO_8601](https://en.wikipedia.org/wiki/ISO_8601) format.
> - **Structure**:
>   
> - **Accessing a field of Date picker type: **
>   - The value of the Date time picker type field:`{{ issue.fields['DTP'] }}`
> 
> > ⚠️ You can use the [date](https://appfire.atlassian.net/wiki/spaces/JMWEC/pages/466323491) filter to manipulate and/or format the value

### Others

> Macro (panel)
> 
> #### <span style="color: #000000">Numeric field</span>
> 
> - **Description:** A field of *Numeric type* is a number.
> - **Structure**:
>   
> - **Accessing a field of Numeric type**:
>   - The value of the field: `{{issue.fields['Numeric field'] }}`
>   - The value of the numeric field minus one:

  


> Macro (panel)
> 
> #### <span style="color: #000000">Project picker type</span>
> 
> - **Description**: A field of *Project picker type* is an object describing a project.
> - **Structure**:
>   
> - **Accessing a field of Project picker type**:
>   - Name of the project: `{{ issue.fields['Project picker type field'].name }}`

  


> Macro (panel)
> 
> #### <span style="color: #000000">URL field type</span>
> 
> - **Description: **A field of *URL type* is a string representation of a URL.
> - **Structure**:
>   
> - **Accessing a field of URL type: **
>   - The value of the URL field: `{{ issue.fields['URL field'] }}`