YouTrack Standalone 2017.2 Help

Create and Edit Custom Fields

As an administrator, you can create, edit, and delete customs field in YouTrack. You can add custom fields to the system and define their properties without attaching them to projects in the system.

Users with project administrator roles can create their own custom fields and attach them to their own projects.

When you create a new field, you can attach it to a project or let the project administrator attach the field as necessary.

Create a Custom Field

The process for creating a custom field differs by field type.

Fields with simple data types store single values. The data type that you assign to the field determines how these values can be used elsewhere in YouTrack. For example, when you assign a field a date data type, the values can be used to generate a report that shows issues that are past due.

To create a custom field with a simple type:

  1. Navigate to Administration > Custom fields > Fields List and click the Add new custom field button.
    • The New Custom Field dialog opens in the sidebar.
    /help/img/youtrack/2017.2/createSimpleFieldStep1_thumbnail.png
  2. Enter values in the custom field settings. For a detailed description of each setting, see Custom Field Settings
  3. Click the Add New Field button.
    • The custom field is added to YouTrack.
  4. To set advanced options, select the new custom field in the list. The following options are available in the toolbar:
    • Enable auto-attach
    • Make private
    • Hide from Issues list

    For more information, see Advanced Options.

Custom fields with enumerated types (enum[* | 1]) such as State State and Priority have a few more options. In addition to the settings that are used for simple types, you must define a list of possible values that can be selected for the field.

To create a custom field with an enumerated type:

  1. Navigate to Administration > Custom fields > Fields List and click the Add new custom field button.
    • The New Custom Field dialog opens in the sidebar.
    /help/img/youtrack/2017.2/createBundleFieldStep1_thumbnail.png
  2. Enter values in the custom field settings. For a detailed description of each setting, see Custom Field Settings
  3. For enumerated types, you have the following options:
    • Select the New set option. Define the set of values after you create the custom field.
    • Select a field from the list. The set of values that is used in the select field is added to the new field.
  4. Click the Add New Field button.
    • The custom field is added to YouTrack.
  5. To set advanced options, select the new custom field in the list. The following options are available in the toolbar:
    • Enable auto-attach
    • Make private
    • Hide from Issues list

    For more information, see Advanced Options.

Edit a Custom Field

You can modify the settings for a custom field to control its visibility and attach it to new projects automatically.

To edit a custom field:

  1. In the Project-related Settings section of the Administration menu, select Custom Fields.
  2. Select the Fields List tab.
  3. Select the field in the list.
  4. Edit the settings shown in the sidebar.
    /help/img/youtrack/2017.2/cfEditDialog_thumbnail.png
  5. Toggle the advanced options in the toolbar. The following options are available:
    • Enable auto-attach/Disable auto-attach
    • Make private/Make public
    • Hide from Issues list/Show in Issues list

    For more information, see Advanced Options.

Delete a Custom Field

When you delete a field that is used in a project, the field is deleted from all issues. Values that were stored in this field are lost. If you delete a custom field that has never been attached to a project, it is deleted without confirmation.

To delete a custom field:

  1. In the Project-related Settings section of the Administration menu, select Custom Fields.
  2. Select the field in the list.
  3. Click the trash button in the toolbar.
  4. Click the Delete button in the confirmation dialog.
Last modified: 9 August 2017