Custom Field Settings
Each custom field has a set of properties that not only affect the values that can be stored in the field but also influence its behavior. For default custom fields, these properties are pre-defined. When you add a custom field, you define these properties in the settings.
When you set these properties on the Fields List tab, you set the default behavior for the custom field. These properties can be set independently on a per-project basis.
Settings for Simple Types
Simple types store data as a
float. Use the following settings to configure fields with simple types.
|Field Name||Stores the name of the custom field. Field names cannot contain the special characters |
:. We also advise against using quotation marks (
") in field names. This character breaks references to field names in the programming language for workflows. If you want to offset words in a field name, use single quotation marks (
|Type||Determines what type of data is stored in the field. |
For most field types, the type is set when the field is created and cannot be changed. If the field stores data as an
float, you can edit this property and convert the data to a target format within this set of types. For example, you can convert an
integer type to a
period type. Here, you have the option to convert the value that is stored as an integer to a number of hours or number of days.
When you select an enumerated type, additional settings that define the selected type are displayed. For more information, see Settings for Enumerated Types.
|Aliases||Assigns the field one ore more keywords that you can use as a substitute for the field name in search queries and commands. For example, the aliases for the default Assignee field are |
assigned to. This lets you use
for: me as a search query instead of
Assignee: <your full name>.
|Can be empty||Determines whether the field can store an empty value. For fields with simple types, this option is always enabled.|
|Empty value name||Assigns a value to show by default in the empty field. This lets you reference the empty value in search queries and commands. |
When you edit an existing field, use the Empty Value setting to update this property.
|Make private||Restricts the visibility of the field to users with permission to view private fields. This property is set system-wide and cannot be changed on a per-project basis. For more information, see Private and Public Issue Fields.|
Settings for Enumerated Types
Enumerated types store one or more values from a predefined set of values. These fields store references to an
build. Use the following additional settings to configure fields with enumerated types.
|Multi-value||Enables the option to store multiple values in the field. This option is not available for fields that store a state type. |
When you edit an existing field, use the Single value and Can specify multiple values toggle to update this property.
|Set of Values||Assigns a default set of values that can be stored in the custom field. |
This option is not visible for fields that store a
- New set — creates a custom field with an empty set of values. You can add values to the set after you create the custom field.
- Existing set — attaches an existing set of values to the field. When you select an existing set of values, you can set the default value to use for this field.
group type. For these fields, the set of possible values is taken from the list of groups in YouTrack.
|Default Value(s)||Assigns a default value to the field. This setting is only available when you select an existing set of values. If the Multi-value setting is enabled, you can select one or more default values.|
|Can be empty||Determines whether the field can store an empty value. You can only disable this option when a default value has been set. |
When you edit an existing field, use the Can be empty and Cannot be empty toggle to update this property.
|Empty value name||Assigns a value to show by default in the empty field. This lets you reference the empty value in search queries and commands. If the Can be empty option is disabled, this setting is disabled as well.|
Last modified: 18 August 2017