Test Management for Jira Server

Configure TM4J

This topic details how to customise your TM4J settings.

Customising Environments, Labels, Iterations, Datasets, and Priorities

  1. Click either Environments, Labels, Iterations, Datasets, or Priorities.

  2. Type a name.
    If you’re adding an environment, iteration, or priority, you can also enter a description, though one isn’t required.

  3. Click Add.
    Your addition appears on the list.

Customising Statuses

You can create custom statuses for test cases, test cycles, test plans, and test executions.

  1. Click an option in the Statuses section.

  2. Enter a status name.
    You can also enter a description, though it isn’t required.

  3. Select a color to represent the status (optional but recommended).

  4. Click Add.
    Your status appears on the list.

Default Statuses

A few essential statuses in TM4J cannot be renamed or deleted. These statuses have theicon.

configuration system default eg

Default statuses can still be archived. (See the Delete and Archive section below.)

Customising Fields

You can create custom fields for test cases, test cycles, test plans, test steps, test executions, and folders.

The following field types are available:

  • Checkbox

  • Date Picker

  • Decimal Number

  • Number

  • Select List (Multi-Choice)

  • Select List (Single Choice)

  • Text Field (Multi-Line)

  • Text Field (Single Line)

  • User Picker

You can define whether each field is required, and you can drag-and-drop to reorder fields.

  1. Click one of the options in the Custom Fields section: Test Cases, Test Plans, Test Cycles, Test Plans, Test Steps, Test Executions, or Folders.

  2. Enter a field name.

  3. Select a field type from the drop-down list.
    If you choose one of the Select List types, you are prompted to add list options. Simply enter a value, then click Add.

  4. Optional: Check the Required box to make the field required.
    Required fields must have a value before a new item (test case, test step, etc.) can be saved.

  5. Click Add.
    Your custom field appears on the list. Hover over the row to edit or delete the field.

Custom fields appear on the Details tab (More Information section) of each test case/plan/cycle/step/execution or folder in the project.


Labels can only be deleted, not archived.

When you delete a label, you are prompted with information on how the label is used throughout TM4J. If the label is used on test artefacts, you are given the option to select a replacement label.

configuration label delete promot

If you select None, there is no replacement for the deleted label.