Skip to main content

Create Custom Field

Creates a custom field.

Permissions required: Administer Jira global permission.

External Documentation

To learn more, visit the Jira documentation.

Basic Parameters​

ParameterDescription
DescriptionThe description of the custom field, which is displayed in Jira.
NameThe name of the custom field, which is displayed in Jira. This is not the unique identifier.
TypeThe 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: )</li><li><code>multigrouppicker</code>: 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☁️ecosystem::extension/e62f20a2-4b61-4dbe-bfb9-9a88b5e3ac84/548c5df1-24aa-4f7c-bbbb-3038d947cb05/static/my-cf-type-key.

Advanced Parameters​

ParameterDescription
Searcher KeyThe 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

Workflow LibraryPreview this Workflow on desktop