YouTrack Standalone 2017.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.

      addValueDialog

  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.

    newValueSetComplete thumbnail

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:

  • Issues list

  • Full page view

  • Agile boards

add value to field thumbnail

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.

    addValuesToBundle thumbnail
  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.

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.

    editSetOfValues thumbnail

  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: 7 March 2019