YouTrack Server 2023.3 Help

Manage Custom Attributes

YouTrack lets you enrich user profiles by adding custom attributes. These attributes can store various data points, including employee start date, employee ID, office location, job title, and much more. To store this additional information, you create custom attributes.

To access the current list of custom attributes:

  1. From the Administration menu, select Access Management > Users.

  2. Click the Manage custom attributes link in the header.

    • The Custom Attributes page opens.

      Custom attributes list in YouTrack.

Accessing Custom Attributes in User Profiles

When custom attributes have been added to the system, fields for storing values for each attribute are added to your users' Hub accounts.

Custom attributes list in a user profile page.

This information is available to the same groups of users who have permission to view and update all profile data. It is not accessible to users who only have access to read basic account information.

If you want to limit who can view and update user profile data, use the information in the following table as a guide:

Permission

Description

Read User Basic

Only grants permission to view the list of registered users and read the ID, username, name, and avatar for each user. This does not grant permission to view values for custom attributes.

Read User Full

Grants permission to view all properties for all registered users, including custom attributes and authorization details.

Implies Read User Basic.

Update Self

Grants users permission to update all profile attributes for their own accounts.

Update User

Grants users permission to update all user profile data.

Implies Update Self and Read User Full.

To learn how to customize the permission scheme in YouTrack, see Manage Permissions.

Add a New Custom Attribute

When you need to add an important piece of information to user profiles, add a custom attribute to YouTrack.

To add a new custom attribute:

  1. From the Administration menu, select Access Management > Users.

  2. Click the Manage custom attributes link in the header.

    • The Custom Attributes page opens.

  3. Click the New custom attribute button at the top of the page.

    • The New Custom Attribute dialog opens.

    The New Custom Attribute dialog.
  4. Enter values for the following settings:

    Setting

    Description

    Name

    Enter a name for the custom attribute.

    Type

    Select the type of information that you want to store for this attribute. You can choose to store the data as a string of text, a number, phone, email, or a password.

    Once the attribute has been added to YouTrack, its type cannot be changed. Be sure to choose the type you want before you create it.

  5. If you want to show values that are stored for each user account in the Users list, select the Show column in list view option.

  6. Click the Create button.

    • A custom attribute with the specified name and type is added to every YouTrack user's Hub account.

Edit Custom Attributes

Once a custom attribute has been added to YouTrack, you can only update its name. The attribute type is only available in a read-only state.

To rename a custom attribute:

  1. From the Administration menu, select Access Management > Users.

  2. Click the Manage custom attributes link in the header.

    • The Custom Attributes page opens.

  3. Locate the attribute in the list and click its name.

    • The detail page for the selected custom attribute opens.

    The detail page for a custom attribute.
  4. Update the value for the Name setting.

  5. Click the Save button.

    • The name of the custom attribute is updated in YouTrack.

Delete Custom Attributes

If you find that you are storing information in user profiles that is no longer required, you can delete this attribute from YouTrack. When you delete a custom attribute:

  • The attribute is completely removed from all user profiles.

  • Any values for this attribute that are currently stored in user accounts are deleted as well. These values are lost and cannot be recovered without restoring a copy of the database prior to the deletion of the attribute.

To delete a custom attribute:

  1. From the Administration menu, select Access Management > Users.

  2. Click the Manage custom attributes link in the header.

    • The Custom Attributes page opens.

  3. Locate the attribute in the list and select it.

  4. Click the Delete button in the header.

    • A confirmation dialog is shown.

    Confirmation dialog for deleting a custom attribute.
  5. Click the Delete button in the confirmation dialog.

    • The custom attribute is deleted.

Last modified: 22 March 2024