YouTrack Cloud 2024.1 Help

Manage Work Item Attributes

Work item attributes let you identify the information you want to capture when users add spent time to their issues. These attributes can then be used to group datasets in timesheets and time reports. Each project can have its own set of attributes and store a project-specific collection of values.

As a project administrator, you can customize the list of work item attributes that are used to track spent time for issues in your projects. System administrators can modify the list of work item attributes for all projects in the system. For more information, see Work Item Attributes.

To access and manage the work item attributes that are used in your project, select the Time Tracking tab in the Edit Project page.

Options for managing the list of work item attributes in a project.

Add a New Work Item Attribute

As a project administrator, you can add new attributes for storing values in work items for your project.

When you add a work item attribute to your project, the attribute is available to other projects in the system. A system administrator or user with global project administration permissions can reuse this attribute in other projects. The set of available values can be managed for each project independently.

To add a new work item attribute:

  1. Click the Projects link in the application header.

  2. Click to open the Show more menu for the project that you want to update, then select Time Tracking from the menu.

    • The Edit Project page opens to the Time Tracking tab.

  3. Click the Add work item attribute button, then select the New work item attribute option.

    • The dialog for adding a work item attribute opens in the sidebar.

      Options for adding a work item attribute to the project.
  4. Enter a name for the new attribute. The name must be unique in the system.

  5. To specify the list of values you want to use for this attribute, click Add value button, then specify a name for the new value. Click the Add button to continue. Repeat this step until you have provided all the values you want to work with.

  6. Click the Save button.

    • The new work item attribute is added to your project.

Add an Existing Work Item Attribute

If you want to use an existing work item attribute to categorize spent time for issues in your project, you can add it to your project. Even though the attribute is used elsewhere, you can manage the set of available values independently for each of your projects.

To add an existing work item attribute to your project:

  1. Click the Projects link in the application header.

  2. Click to open the Show more menu for the project that you want to update, then select Time Tracking from the menu.

    • The Edit Project page opens to the Time Tracking tab.

  3. Click the Add work item attribute button.

  4. Select the name of an existing work item from the list.

    Options for adding an existing work item attribute to the project.
  5. Check the current list of values that are used for the selected attribute a name for the new attribute.

    • If you're happy with the current list, you're done.

    • If you want to modify the list, you can add and remove values in your project. Usages of this attribute in other projects are not affected.

      To learn more, see Update Work Item Attributes below.

Update Work Item Attributes

If you want to update any of the work item attributes that are used in your project, you can update them directly on the Time Tracking tab.

When you update a work item attribute at the project level, these changes are only applied in the current project. A system administrator can apply changes that affect all the projects in the system. This includes the ability to:

  • Rename attribute.

  • Set the order in which the values are shown when users add spent time records to issues.

Neither of these options is available at the project level. To learn more, see Work Item Attributes.

To update a work item attribute:

  1. Click the Projects link in the application header.

  2. Click to open the Show more menu for the project that you want to update, then select Time Tracking from the menu.

    • The Edit Project page opens to the Time Tracking tab.

  3. Select the work item attribute that you want to update.

  4. Use one or more of the following actions to update the work item attribute:

    • To add a value for the attribute, click the Add value button. Enter a name for the new value, then click the Add button.

    • To edit an existing value, click to open the Show more menu, then select Edit. Update the name or color, then click Save to update the value.

    • To remove a value, click to open the Show more menu, then select Remove. Click the Confirm button in the confirmation dialog to confirm this action.

    Options for updating a work item attribute in a project.

Remove a Work Item Attribute

If there are any work item attributes in your project that you don't use or need, you can remove them.

To remove a work item attribute from your project:

  1. Click the Projects link in the application header.

  2. Click to open the Show more menu for the project that you want to update, then select Time Tracking from the menu.

    • The Edit Project page opens to the Time Tracking tab.

  3. Select the attribute that you want to remove from the list.

  4. Click to open the Show more menu, then select Remove from project.

    Option for removing a work item attribute from a project.

    This option is also available from the Show more menu in the details panel.

Last modified: 08 March 2024