Create Custom Field
Creates a custom field.
Permissions required: Administer Jira global permission.
External Documentation
To learn more, visit the Jira documentation.
Basic Parameters
Parameter | Description |
---|---|
Description | The description of the custom field, which is displayed in Jira. |
Name | The name of the custom field, which is displayed in Jira. This is not the unique identifier. |
Type | The type of the custom field. These built-in custom field types are available:cascadingselect : Enables values to be selected from two levels of select lists (value: com.atlassian.jira.plugin.system.customfieldtypes:cascadingselect )datepicker : Stores a date using a picker control (value: com.atlassian.jira.plugin.system.customfieldtypes:datepicker )datetime : Stores a date with a time component (value: com.atlassian.jira.plugin.system.customfieldtypes:datetime )float : Stores and validates a numeric (floating point) input (value: com.atlassian.jira.plugin.system.customfieldtypes:float )grouppicker : Stores a user group using a picker control (value: com.atlassian.jira.plugin.system.customfieldtypes:grouppicker )importid : A read-only field that stores the ID the issue had in the system it was imported from (value: com.atlassian.jira.plugin.system.customfieldtypes:importid )labels : Stores labels (value: com.atlassian.jira.plugin.system.customfieldtypes:labels )multicheckboxes : Stores multiple values using checkboxes (value: )<br/> * `multigrouppicker`: Stores multiple user groups using a picker control (value: )multiselect : Stores multiple values using a select list (value: com.atlassian.jira.plugin.system.customfieldtypes:multicheckboxes )multiuserpicker : Stores multiple users using a picker control (value: com.atlassian.jira.plugin.system.customfieldtypes:multigrouppicker )multiversion : Stores multiple versions from the versions available in a project using a picker control (value: com.atlassian.jira.plugin.system.customfieldtypes:multiversion )project : Stores a project from a list of projects that the user is permitted to view (value: com.atlassian.jira.plugin.system.customfieldtypes:project )radiobuttons : Stores a value using radio buttons (value: com.atlassian.jira.plugin.system.customfieldtypes:radiobuttons )readonlyfield : Stores a read-only text value, which can only be populated via the API (value: com.atlassian.jira.plugin.system.customfieldtypes:readonlyfield )select : Stores a value from a configurable list of options (value: com.atlassian.jira.plugin.system.customfieldtypes:select )textarea : Stores a long text string using a multiline text area (value: com.atlassian.jira.plugin.system.customfieldtypes:textarea )textfield : Stores a text string using a single-line text box (value: com.atlassian.jira.plugin.system.customfieldtypes:textfield )url : Stores a URL (value: com.atlassian.jira.plugin.system.customfieldtypes:url )userpicker : Stores a user using a picker control (value: com.atlassian.jira.plugin.system.customfieldtypes:userpicker )version : Stores a version using a picker control (value: com.atlassian.jira.plugin.system.customfieldtypes:version )To create a field based on a Forge custom field type, use the ID of the Forge custom field type as the value. For example, ari:cloud:ecosystem::extension/e62f20a2-4b61-4dbe-bfb9-9a88b5e3ac84/548c5df1-24aa-4f7c-bbbb-3038d947cb05/static/my-cf-type-key . |
Advanced Parameters
Parameter | Description |
---|---|
Searcher Key | The searcher defines the way the field is searched in Jira. For example, com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher. The search UI (basic search and JQL search) will display different operations and values for the field, based on the field searcher. You must specify a searcher that is valid for the field type, as listed below (abbreviated values shown): cascadingselect : cascadingselectsearcher datepicker : daterange datetime : datetimerange float : exactnumber or numberrange grouppicker : grouppickersearcher importid : exactnumber or numberrange labels : labelsearcher multicheckboxes : multiselectsearcher multigrouppicker : multiselectsearcher multiselect : multiselectsearcher multiuserpicker : userpickergroupsearcher multiversion : versionsearcher project : projectsearcher radiobuttons : multiselectsearcher readonlyfield : textsearcher select : multiselectsearcher textarea : textsearcher textfield : textsearcher url : exacttextsearcher userpicker : userpickergroupsearcher * version : versionsearcher If no searcher is provided, the field isn't searchable. However, Forge custom fields have a searcher set automatically, so are always searchable. |
Example Output
{
"clauseNames": [
"cf[10101]",
"New custom field"
],
"custom": true,
"id": "customfield_10101",
"key": "customfield_10101",
"name": "New custom field",
"navigable": true,
"orderable": true,
"schema": {
"custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
"customId": 10101,
"type": "project"
},
"searchable": true,
"untranslatedName": "New custom field"
}
Workflow Library Example
Create Custom Field with Jira and Send Results Via Email