Raw value/text input for fields

This document lists the expected text/raw input value that should be provided to set Jira Standard and Custom fields. The easiest is to use the "Expected Value" tab of the Groovy editor help system. It lists the possible expected values for the selected Field and Value Type. This is applicable in contexts where you set a field value or comment an issue or write a conditional Groovy script. Select the Field and Value Type as Set field value to constant or Groovy template. Click on Expected Value. The help editor displays the expected text/Groovy templates values for the selected field.

You might also want to look at Standard fields, Predefined custom fields, and User-created custom fields to know how to access the fields of an issue object.

On this page:

Standard Jira fields

Field Name	Expected input value	Examples
Affects Version/s	Version name or id (id takes precedence over the name) should be provided To set multiple values, you should provide version names or ids (id takes precedence over the name) separated by a comma.	`2.0` `10000` `2.0,3.0` `10020,V1`
Assignee	Any of the following user detail should be provided: Username Email address Full name It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `charliej@abc.com` `Joe White`
Component/s	Component name or id (id takes precedence over the name) should be provided To set multiple values, you should provide component names or ids (id takes precedence over the name) separated by a comma.	`C1` `C1,C2` `10000`
Description	Any simple single/multi-line text should be provided	`Test` `Testing of` `First project` `Second project`
Due Date	String representing a timestamp in the format specified in Jira system settings.	`11/Apr/17`
Environment	Any simple single/multi-line text should be provided	`QA Environment`
Fix Version/s	Version name or id (id takes precedence over the name) should be provided To set multiple values, you should provide version names or ids (id takes precedence over the name) separated by a comma	`2.0` `2.0,3.0` `10020`
Issue type	Use with caution! Changing the issue type should only be done if the current and new issue types share the same workflow, or if the issue's Status exists in both the current and new workflow. Otherwise, the operaton will fail. Also, when changing the issue type of the current issue, make sure to move the post-function below the "Set issue status to the linked status of the destination workflow step" built-in post-function. String representing the issue type name or id	`Bug` `10020`
Labels	String representing a label should be provided. To set multiple labels, you should provide values separated by space.	`NewLabel` `Label1 Label2 Label3`
Original Estimate	Number representing the estimate in seconds or a duration string should be provided.	`36000` `3w 2d` `2w 4d 5h 50m`
Priority	Priority name or id (id takes precedence over the name) should be provided	`High` `2`
Remaining Estimate	Number representing the estimate in seconds or a duration string should be provided.	`36000` `3w 2d` `2w 4d 5h 50m`
Reporter	Any of the following user detail should be provided: Username Email address Full name It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `charliej@abc.com` `Joe White`
Resolution	Resolution name or ID (id takes precedence over the name) should be provided	`Won't Do` `11212`
Security level	Security level name or id (id takes precedence over the name) should be provided	`QA1` `10001`
Status	Use with caution! Changing the Status of an issue is normally done only through an issue transition. Changing the Status field value directly will not validate potentially required fields (such as the Resolution field), and will leave no trace in the issue history. This should be used only in specific cases. Also, when changing the Status of the current issue, make sure to move the post-function below the "Set issue status to the linked status of the destination workflow step" built-in post-function. Finally, the Status field cannot be set during a Create transition. String representing the status name or status id	`Open` `10020`
Summary	Any simple single/multi-line text should be provided	`This is the summary of the issue`
Time Spent	Number representing the time spent in seconds or a duration string should be provided.	`36000` `3w 2d` `2w 4d 5h 50m`
Votes	Any of the following user detail should be provided: Username Email address Full name To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma. It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `carter,charlie` `charliej@abc.com` `Joe White, charliej@abc.com`
Watchers	Any of the following user detail should be provided: Username Email address Full name To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma. It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `carter,charlie` `charliej@abc.com` `Joe White, charliej@abc.com`

Pre-defined custom fields

Capture for JIRA fields

Field Name	Expected input value	Examples
All Capture for JIRA fields	Any simple single/multi-line text should be provided	All the Capture for JIRA fields expect a text value.
Raised during	Session ID should be provided. The session ID can be obtained from the URL when you view the session.	`10010`

Jira Software fields

Field Name	Expected input value	Examples
Epic Color	Any simple single/multi-line text should be provided	`ghx-label-6`
Epic Link	Issue KEY of an Epic should be provided	`TEST-300` `TP-33`
Epic Name	Any simple single/multi-line text should be provided	`Creation of a new issue`
Epic Status	Status value should be provided	`To Do` `Done`
Sprint	String representing the ID of the sprint should be provided.	`1`
Story points	String representing the number of story points should be provided	`5`

Jira Service Desk fields

Field Name	Expected input value	Examples
Approvers	Any of the following user detail should be provided: Username Email address Full name To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma. It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `carter,charlie` `charliej@abc.com` `Joe White, charliej@abc.com`
Customer Request Type	Customer Request Type name or internal ID	IT help sd/desktoplaptopsupport
Organizations	Organization name ID should be provided. To set multiple values, you should provide the Organization names or IDs separated by a comma.	`Org1` `Org1,Org2` `1` `1,33`
Request Participants	Any of the following user detail should be provided: Username Email address Full name To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma. It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `carter,charlie` `charliej@abc.com` `Joe White, charliej@abc.com`

Portfolio for Jira fields

Field Name

Expected input value

Examples

Parent Link

Issue KEY of an Initiative should be provided.

Note: You can use this field to create a link (Jira Portfolio Parent Link) from Epic to Initiative

KP-9

Tempo fields

Field Name	Expected input value	Examples
Account	The Account Id, key, or name should be provided. Key is preferred	`23` `ACCOUNT1` `Account 1`
Team	Team ID should be provided. The Team ID can be obtained from the URL when you view or edit the team.	`2` `3`

User-created custom fields

The value expected by custom fields depends on the Custom Field Type:

Select list type

Custom field type	Expected input value	Examples
Checkboxes/Select List (multiple choices)	Option id or value (value* takes precedence over the id)* should be provided. The option id can be obtained from the URL when you edit the option. To set multiple options, you should provide option values or ids (value takes precedence over the id) separated by a comma.	`10000` `Option1, Option2` `10000,10002`
Radio Buttons/Select List (single choice)	Option id or value (value* takes precedence over the id)* should be provided. The option id can be obtained from the URL when you edit the option.	`10003` `Option2`
Select List (cascading)	Cascading parent value or id should be provided Cascading parent value or id and child option value or id should be provided in `<parent value> - <child option>` format.	`2` `2 - 2.1` `10202` `10202 - 10301`
Multi-level cascading select list	A comma-separated list of option values, from parent to child A comma-separated list of option IDs, from parent to child	`Parent 1,Child A,Child b` `10010,10011,10100`

Group picker

Custom field type	Expected input value	Examples
Group Picker (single group)	Group name should be provided	`jira-administrators`
Group Picker (multiple groups)	Group name should be provided To set multiple values, you should provide group names separated by a comma.	`jira-administrators,jira-software-users`

User picker

Custom field type

Expected input value

Examples

User Picker (multiple users)

Any of the following user detail should be provided:
- Username
- Email address
- Full name
To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma.

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.

carter
carter,charlie
charliej@abc.com
Joe White, charliej@abc.com

User Picker (single user)

Any of the following user detail should be provided:

Username
Email address
Full name

It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.

carter
charliej@abc.com
Joe White

Version picker

Custom field type	Expected input value	Examples
Version Picker (single version)	Version id or name (id* takes precedence over the name)* should be provided	`10020` `2.0`
Version Picker (multiple versions)	Version id or name (id* takes precedence over the name)* should be provided To set multiple values, you should provide version ids or names (id* takes precedence over the name)* separated by a comma.	`10020` `2.0` `10020,10010` `1.0,2.0`

Text

Custom field type	Expected input value	Examples
Text Field (single line)	Any simple single/multi-line text should be provided	`This is a text line`
Text Field (multi-line)	Any simple single/multi-line text should be provided	`First line` `Second line`

Date/Time picker

Custom field type	Expected input value	Examples
Date Picker	String representing a timestamp in the format specified in Jira system settings	`23/Dec/16`
Date Time Picker	String representing a timestamp in the format specified in Jira system settings	`23/Dec/16 2:00 AM`

Watchers Field type

Custom field type	Expected input value	Examples
Watchers field	Any of the following user detail should be provided: Username Email address Full name To set multiple values, you can provide a combination of user details (as mentioned above) separated by a comma. It is recommended you use Username(s) because Email address(es) and Full name(s) are not unique in Jira.	`carter` `carter,charlie` `charliej@abc.com` `Joe White, charliej@abc.com`

Others

Custom field type	Expected input value	Examples
Project Picker (single project)	Project id or name or key should be provided	`10000` `TEST` `Test`
Labels	String representing a label should be provided. To set multiple labels, you should provide values separated by space.	`NewLabel` `Label1 Label2 Label3`
URL Field	Any simple text of URL format should be provided	`https://innovalog.com`
Number Field	Number should be provided	`33` `0.5`