YouTrack Standalone 2018.3 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. The operations that are described on this page are performed on the Fields List tab of the Custom Fields Settings page. This tab is only visible to users who have the Low-level Admin Read permission.

Users with project administrator roles can create their own custom fields and attach them to their own projects. These operations can be performed on the Fields in Projects tab of the Custom Fields Settings page or on the Fields tab of the Edit Project page. The minimum set of permissions that are required to perform these tasks is Read Project Basic and Update Project. For project-specific instructions, see Manage Custom Fields.

When you add a field to the system as an administrator, you can attach it to one or more projects or let the project administrators choose to attach the field to their own projects.

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. From the Core Features section of the Administration menu, select Custom Fields.

  2. Select the Fields List tab.

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

    new custom field with simple type
  4. Enter values in the custom field settings. For a detailed description of each setting, see Custom Field Settings

  5. Click the Add New Field button.
    • The custom field is added to YouTrack.

  6. 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 Global Default Settings.

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. From the Core Features section of the Administration menu, select Custom Fields.

  2. Select the Fields List tab.

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

    new custom field with enumerated type
  4. Enter values in the custom field settings. For a detailed description of each setting, see Custom Field Settings

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

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

  7. 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 Global Default Settings.

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. From the Core Features 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.

    edit custom field default settings

  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 Global Default Settings.

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. From the Core Features 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: 7 March 2019