Updated on 2026-10-26 GMT+08:00

Configuring Work Item Fields

You can configure and maintain the fields used by each work item type under a tenant. In addition to the preset system work item fields, you can customize tenant-level fields as required. The configured fields take effect in all projects that use the fields.

Constraints

The preset system work item fields cannot be edited or deleted.

Prerequisites

You must have the permissions of the Tenant Administrator role. For details about how to assign the Tenant Administrator role to a user, see Creating a User Group and Assigning Permissions.

Creating a Work Item Field

  1. Access the CodeArts Req homepage and click .
  2. Choose All Account Settings.
  3. Choose Work Item Management > Basic Settings > Work Item Fields. The preset work item fields are displayed.
  4. Click Create Field. In the displayed window, set the field information. For details, see Table 1.

    Table 1 Parameters for creating a work item field

    Parameter

    Description

    Field Name

    Name of the new field. The field name must be unique.

    Field Type

    Type of the new field. The options are Single-choice list, Multi-choice list, Single-line text, Multi-line text, Date, Date and time, Integer, Decimal, Single-choice user, Multi-choice user, Level field, and Review check items.

    Options

    This parameter is displayed only when Field Type is set to Single-choice list, Multi-choice list, or Level field.

    • When Field Type is set to Single-choice list or Multi-choice list, you can click Add Option to add one option at a time. To add multiple options at a time, click Add Multiple. Separate options by pressing Enter.

      When there are multiple options, you can drag to adjust their positions.

    • When Field Type is set to Single-choice list or Multi-choice list, you can click to delete options. There is a default option, which cannot be deleted.
    • When Field Type is set to Level field, click Edit Option. In the Edit Option dialog box, click on the right of the text box to add field levels. A maximum of six levels can be added. Click Add Option to add fields of the same level. Click Add Multiple to add multiple options at a time.

    Description

    Description of the new field. This parameter is optional. Configure it as needed.

  5. Click Publish. The new field is displayed in the list.

    You can perform the following operations on a new field.
    Table 2 Managing fields

    Operation

    Description

    Edit field

    Click to modify the field name, type, and description.

    Delete field

    Click . In the displayed dialog box, click Delete to delete the field.

    NOTE:

    If the current field has been associated with a work item type, cancel the association before deleting the field.