YouTrack Standalone 2018.3 Help

Manage Sets of Values

Sets of values can be used in custom fields with enumerated types, like enum[1|*]. The default custom fields State, Priority, and Build are also enumerated types. This page describes how to create, edit, and customize sets of values.

These procedures describe how to configure a generic enum[1|*] type. For other sets of values like states, builds, subsystems, and versions, the procedure is similar and is not explicitly described.

The set of values for a user field type, which defines the assignees in a project, must be configured in a specific way. For more information, see Manage Assignees.

Create a New Set of Values

You define the set of values after you create a field with an enumerated type.

To create a new set of values:

  1. Open the Administration > Custom Fields page.

  2. Select the Fields List tab.

  3. Click the Add new custom field button.
    • The New Custom Field dialog opens in the sidebar.

  4. In the New Custom Field dialog, enter a Field Name.

  5. In the Type drop-down list, select enum.

  6. Click the Add new field button.
    • The custom field is added to YouTrack.

    • The custom field settings are displayed in the sidebar.

  7. Click the Create new set button

  8. Click the Add value button.
    • The Add Value dialog opens.

      Add value dialog

  9. 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.

  10. Repeat from step 7 until you have added all of the values that you want to use for the custom field.

    new set of values for custom field

Add Values to a Set

To add values to an existing set, you can either add a new value manually or copy/merge/replace existing values from another set of values.

Wherever you can change the value for a field, there is an option to add a new value to the set. Project administrators can add values to fields that are unique to thier projects or use an independent set of values. System administrators and users with project administrator access in the global project can add values to the set in all projects. When created, the new value is added to the issue. This option is visible in the following locations:

  • The Issues list

  • Single issue view

  • Agile boards

Add value to field

If the field uses an independent set of values, the value is added to the custom field in the project that is assigned to the issue.

You can add values to a custom field on the Custom Fields Settings page.

To add a value to a set:

  1. Open a custom field with an enumerated type.

  2. 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.
  3. Click the Add value button.
    • The Add Value dialog opens.

    add value to set
  4. Enter values in the following fields:
    • Name (mandatory)

    • Description

  5. 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.

  6. Click the Save button.

Sort Values in a Set

By default, the values in a set are ordered manually in the order that they were added to the field. When ordered manually, each value is assigned an ordinal value that represents its position in the list.

The sort order affects the following behavior in YouTrack:

  • 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.

    Sort values custom fields

  • 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 .. Major returns issues that are Show-stopper, Critical, and Major.

As an administrator, you have the ability to determine the sort order for values in fields that are used in multiple projects. Project administrators can set the sort order independently per project by managing an independent copy of the set of values. For more information, see Sort Values in a Set.

You can sort values in a custom field on the Fields List tab of the Custom Fields Settings page. Sort options are available for all fields that store enumerated types except for fields that store a user or group type.

  • For fields that store a user type, the values are automatically sorted alphabetically by full name, with the current user at the top of the list.

  • For fields that store a group type, values are sorted alphabetically by name.

Sort Values Manually

If you want to override the default order in which values appear in a custom field, you can manually resort the values in the list.

To resort values that are sorted manually:

  1. Select a custom field with a set of values that can be sorted.

  2. 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.
  3. Drag the values into the desired order.
    • The custom order is saved automatically.

    Update manual sort order

Sort Values by Name

For any field that supports manual sorting, you have the option to automatically sort values by name. Values can be sorted by name in ascending or descending order. When sorted by name, new values that are added to the set are shown in alphabetical order.

When you switch from manual sorting to any other sort option, the manual option is discarded. If you revert to sorting values manually, you have to reapply the custom order.

To sort values by name:

  1. Select a custom field with a set of values that can be sorted.

  2. 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.
  3. Open the sort menu and select the Sort by name option.

    Sort values by name

  4. 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.

  5. If you want to sort the values in descending order, select the desc option from the drop-down list.

Sort Values by Version

For fields that store a version or build, you have the option to sort values by version. Values can be sorted by version in ascending or descending order. With this option, numeric values are sorted automatically according to the Semantic Versioning Specification (SemVer).

The most valuable application of this feature is in a search query. For many teams, the ability to search for issues that were fixed in a specific range of versions or builds helps to generate an accurate list for the publication of release notes.

To sort values by version:

  1. Select a custom field that stores a version or build.

  2. 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.
  3. Open the sort menu and select the Sort by version option.

    Sort values by version

  4. 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.

  5. If you want to sort the values in descending order, select the desc option from the drop-down list.

Additional Sort Options

For fields that store a version or build, you have the option to sort values by the additional properties that are stored for each value. Values can be sorted by these properties in ascending or descending order.

Field Type

Sort Option

Description

version

release date

Values are sorted chronologically by release date.

build

assemble date

Values are sorted chronologically by assemble date.

To sort values by either of these properties, follow the instructions for other automatic sort options as described above.

Edit a Set of Values

As an administrator, you can edit the set of values that are used in a field for all projects in the system.

To edit a set of values system-wide:

  1. Open the Administration > Custom Fields > Fields List tab.

  2. Select the field that uses the set of values.
    • The details dialog for the selected custom field opens in the sidebar.

  3. Click the Edit set for all affected projects button.

    edit set of values

  4. 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.

Copy Values from Another Set

If you have a custom field that contains a set of values that you would like to use as the basis for another custom field, you can copy the values from another set.

To copy values from another set:

  1. Select the field where you want to edit the list of values.

  2. Select whether you want your changes to affect all projects.

  3. Click the Copy values from button and select a field that contains the values you want to copy.
    • The values from the selected field are added to the current set of values.

Merge Values with Another Set

When you merge two sets of values, you get a single set with a common collection of values that is available in all of the projects where the field was used before the merge.

To merge another set of values with the current set:

  1. Select the field where you want to edit the list of values.

  2. Select whether you want your changes to affect all projects.

  3. Click the Merge with button and select the field you want to merge with.
    • The values from the selected field are merged with the current set of values.

Last modified: 12 October 2018