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 string
, date
, period
, integer
, or float
.
Use the following settings to configure fields with simple types.
Field | Description |
---|---|
Field Name | Stores the name of the custom field.
Field names cannot contain the special characters < , > / , or : .
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 (' ) instead. |
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 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 for and 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 enum
, group
, user
, ownedField
, state
, version
, or build
.
Use the following additional settings to configure fields with enumerated types.