JetBrains Space Help

Custom Fields in Issues

Every issue comes with a set of commonly-used default fields shown in its right-hand sidebar, such as Assignee, Due date, Status, Tag.

If your team needs additional categories for issues, you can define and add custom fields. They can be used to store values for prioritizing, scheduling, references, specifications, or whatever else your team needs for efficient work.

Custom fields can be created of different types to accomodate for specific value format, such as:

  • Text- to enter and store a simple line of text

  • Date- to set a date picked from a calender

  • List- to choose from a number of predefined values

and many more. For a full list and description, see Custom field types.

Create, edit, delete custom fields

Create a custom field

  1. Open your project.

  2. On you project sidebar, choose Issues.

  3. On the Issues page, click the Settings button:

    chooseIssueSettings.png
  4. On the issues Settings page, go to the Custom Fields tab:

    issueSettingsCustomFields.png
  5. You can quickly add a preconfigured custom field (Browser, Priority or Type). Choose it from the drop-down menu, review and edit the options (if necessary), and click Save:

    issuesNewFieldPredefined.png

    To create a custom field from scratch, with your own settings, click the New field button and fill out the form:

    issuesNewCustomFieldForm.png

    Enter the Field name and select its Type. The settings and options will depend on the type you choose. For a detailed description of each setting, see Custom field settings.

  6. Use the interactive Live preview at the bottom of the form to see and test your custom field.

  7. When you're done, click Save. The new custom field will be added to your project issues.

Edit custom field settings

  1. On the Issues page, click the Settings button:

    chooseIssueSettings.png
  2. On the issues Settings page, go to the Custom Fields tab:

    issuesCustomFieldsList.png
  3. On the custom fields list, and click edit next to the field you want to edit.

  4. Refer to the custom fields settings and types descriptions to edit the settings.

Delete a custom field

  1. On the Issues page, click the Settings button:

    chooseIssueSettings.png
  2. On the issues Settings page, go to the Custom Fields tab:

    issuesDeleteArchiveCustomField.png
  3. On the custom fields list, locate the field you want to delete or archive, click ... next to the field and choose a corresponding option.

Custom field types

TypeDescription
TextCan be used to enter and store a short text (string of alphanumeric characters)
NumberCan store integers only.
ListA selection of predefined values (list items) that users can choose from (or add their own if the Open-ended option is enabled)
CheckboxA checkbox can be used for any binary input. For example, you can provide some question in its description, and the users can answer 'yes' by selecting the checkbox.
DateStores a single value in a date format. Users set and change the value by picking a date from a calendar popup.
Date and TimeStores a single value in a date/time format. Users set and change the value by picking a date and time from a calendar popup.
PercentageStores a single integer value (from 0 to 100 by default) and shows it along with a progress bar.
Organization memberStores a reference to a member profile. Users can pick a member from a drop-down list.
TeamStores a reference to one of the teams in your organization. Users can pick a team from a drop-down list.
LocationStores a reference to one of the locations defined in your organizaton. Users can pick a location from a drop-down list.
ProjectStores a reference to one of the projects in your organizaton. Users can pick a project from a drop-down list.
LinkCan be used to provide and store a link to an internal or external resource.
IssueCan be used to store a link to a related issue. To enter a reference to an issue, users should copy the issue ID link on the issue page and paste it into the field.

Custom field settings

Common settings. The following settings are available for all field types:

SettingDescription
Field nameName of the custom field as it appears on the issue to all viewers
Description(Optional) A short description of the field's purpose visible to all viewers. Can be added if the field name is not informative enough.
TypeDetermines what type of data can be stored in the field and in what format. For a detailed description of all field types, see Custom field types
Multiple values possibleEnables the field to store more than one value
Required fieldMakes input mandatory. An issue cannot be created, unless a value is entered in this field.
Default valueSet a value to pre-populate the field. The value will be stored and displayed in the field until someone inputs a different value. If your field type is Checkbox, the defalt value is either checked or unchecked.

Type-specific settings. The following settings are only available for certain field types:

SettingTypeDescription
Multi-valueText, Number, List, Organization member, IssueAllow users to enter and store more than one value in the field. This option is set upon the creation of the field and cannot be edited after the field is created.
Open-endedListIn addtion to selecting predefined values, allow users to add new values (list items) to the list right on the spot.
ValuesListDefine a list of values (list items) for users to choose from. Enter a value than click Add another to enter another one. Repeat until you have defined all values.
ConstraintsText, Number, Date, Date and Time

Restrict and validate user input by setting constrains for entered values.

  • Depending on the field type, you can specify the minimum and maximum number of characters that can be entered, set a range for date selection, and so on.

  • Pattern. Use Regular Expressions to apply additional restrictions, such as predefined format and order of characters.

  • Error message. Provide a message that will be shown to the users if they enter invalid values.

Change custom field order

By default, custom fields are displayed on an issue page in the order they were created, from top to bottom. To rearrange existing custom fields:

  1. On the Issues page, click the Settings button:

    chooseIssueSettings.png
  2. On the issues Settings page, go to the Custom Fields tab:

    issuesReorderCustomFields.png
  3. Set the desired order of custom fields by dragging them up or down the list.

Last modified: 04 June 2021