Manage Sets of Values
note
A single set of values can be used in multiple custom fields in different projects. Different projects can use independent sets of values for the same custom field.
Create a New Set of Values
To create a new set of values:
tip
Requires permissions: Low-level Admin Write
From the Core Features section of the Administration menu, select Custom Fields.
Select the Fields List tab.
Click the Add new custom field button.
The New Custom Field dialog opens in the sidebar.
In the New Custom Field dialog, enter a Field Name.
In the Type drop-down list, select
enum.Click the Add new field button.
The custom field is added to YouTrack.
The custom field settings are displayed in the sidebar.
Click the Create new set button
Click the Add value button.
The Add Value dialog opens.
In the Add Value dialog, enter a Name and optional Description, select an optional color scheme (a combination of background and text colors), then click the Save button.
Repeat from step 7 until you have added all of the values that you want to use for the custom field.
Add Values to a Set
To add a value to a set:
tip
Requires permissions: Low-level Admin Write
From the Core Features section of the Administration menu, select Custom Fields.
Select the Fields List tab.
Select a custom field with an enumerated type.
If the custom field is attached to one or more projects, you have the following options:
Edit set for all affected projects — values added to the list are available in all projects that use this field.
Make independent copy — values added to the list are only available in the current project.
Select the option that suits your purpose.
Click the Add value button.
The Add Value dialog opens.
Enter values in the following fields:
Name (mandatory)
Description
Optionally, select a color scheme (a combination of background and text colors). For example, for a set of values in the Priorities field, you can opt to highlight Critical and Show-stopper values in red.
Click the Save button.
Sort Values in a Set
The values that are displayed in drop-down lists for custom fields are displayed in the specified sort order. For example, the values for the default Priority field are sorted manually from highest to lowest. The value that represents the highest priority (Show-stopper) appears at the top of the list.
In search queries that specify a range of values, the sort order determines which values match the search request. For example, a search request that includes
Priority: Show-stopper .. Majorreturns issues that are Show-stopper, Critical, and Major.
Sort Values Manually
To resort values that are sorted manually:
tip
Requires permissions: Low-level Admin Write
From the Core Features section of the Administration menu, select Custom Fields.
Select the Fields List tab.
Select a custom field with a set of values that can be sorted.
If the custom field is attached to one or more projects, you have the following options:
Edit set for all affected projects — the custom sort order is applied in all projects that use this set of values.
Make independent copy — the custom sort order is stored in the default set of values for the field.
Select the option that suits your purpose.
Drag the values into the desired order.
The custom order is saved automatically.
Sort Values by Name
To sort values by name:
tip
Requires permissions: Low-level Admin Write
From the Core Features section of the Administration menu, select Custom Fields.
Select the Fields List tab.
Select a custom field with a set of values that can be sorted.
If the custom field is attached to one or more projects, you have the following options:
Edit set for all affected projects — the sort order is applied in all projects that use this set of values.
Make independent copy — the sort order is stored in the default set of values for the field.
Select the option that suits your purpose.
Open the sort menu and select a Sort by name option (either case-sensitive or case-insensitive).
Confirm the action in the Change Sort Order dialog.
If the values were previously ordered manually, the manual order is discarded.
The values in the set are sorted by name in ascending alphabetical order.
If you want to sort the values in descending order, select the desc option from the drop-down list.
Sort Values by Version
To sort values by version:
tip
Requires permissions: Low-level Admin Write
From the Core Features section of the Administration menu, select Custom Fields.
Select the Fields List tab.
Select a custom field that stores a
versionorbuild.If the custom field is attached to one or more projects, you have the following options:
Edit set for all affected projects — the sort order is applied in all projects that use this set of values.
Make independent copy — the sort order is stored in the default set of values for the field.
Select the option that suits your purpose.
Open the sort menu and select the Sort by version option.
Confirm the action in the Change Sort Order dialog.
If the values were previously ordered manually, the manual order is discarded.
The values in the set are sorted by version in ascending order.
If you want to sort the values in descending order, select the desc option from the drop-down list.
Edit a Set of Values
To edit a set of values system-wide:
tip
Requires permissions: Low-level Admin Write
From the Core Features section of the Administration menu, select Custom Fields.
Select the Fields List tab.
Select the field that uses the set of values.
The details dialog for the selected custom field opens in the sidebar.
Click the Edit set for all affected projects button.
Edit the set of values. The following options are available:
Click the Add value button to add a new value to the list.
Click the Copy values from button and select a field to copy the values used in the selected field. For more information, see Copy Values from Another Set.
Click the Merge with button and select a field to merge existing values with the values used in the selected field. For more information, see Merge Values with Another Set.
