We’re excited to announce that TM4J - Test Management for Jira is now part of the SmartBear family. Learn more : https://smartbear.com/blog/test/test-management-for-jira-joins-the-smartbear-family/

This documentation has moved. For the most recent documentation, check out https://docs.adaptavist.com. Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata

The title of this documentation page was recently updated, so please update your bookmark!

Test Management for Jira is highly customizable, and you can configure every part of the system—testing statuses, environments, labels, custom fields, etc.—to suit your specific project's needs.

Locate the Configuration Settings

To access the configuration settings, click the Ellipses icon in the upper-right corner of any screen.

There are three sections for you to customize: Configuration, Statuses, and Custom Fields.

Customizing Environments and Labels

  1. Click either Environments or Labels.
  2. Type a name.
    If you're adding an environment, you can also enter a description, though one isn't required.
  3. Click Add.
    Your addition appears on the list.

Customizing Statuses

  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.

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

Customizing Fields for Test Cases, Cycles, Plans, Steps, and Executions

You can create custom fields for test cases, test cycles, and test plans, test executions, and test steps. 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 Steps, or Test Execution.
  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 test case/plan/cycle/step/execution 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 in the project.

Delete and Archive

You can delete or archive any custom additions you make to TM4J.

  • Delete - Permanent removal from the app.
  • Archive - Renders the option invisible and inactive throughout TM4J but saves it in the configuration settings in case you want to activate it later.

Hover over any row, and click the cog to access the drop-down options.

If you click Delete, you are prompted to verify your choice, as deletion is permanent. Some items currently in use within the app cannot be deleted.

If you click Archive, your item becomes gray and inactive. You can reactivate it by clicking the cog, then Unarchive.


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.

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

  • No labels