Test Management for Jira Server

Configure Jira Project Settings

Project-level settings allow you to customise characteristics of TM4J projects within your Jira. Some projects should have different permissions/restrictions, issue types, and traceability-link schemes, which you can adjust project by project, as needed.

You must be a project admin to change Jira project settings.

Accessing Jira Project Settings

  1. Click the Gear icon in the upper-right corner of the screen, then click Projects.

  2. Click on a project for which you’d like to access settings.

  3. Scroll down the page, and click Test Management for Jira in the panel on the left side of the page.

    config tm4j

Enable/Disable the App

Use this setting to enable or disable TM4J.

Disabling TM4J projects does not delete data.

config enable

Enable/Disable Issue Types

Use this section to enable/disable specific issue types for the project.

issue types

Traceability Options for Jira Issues

This section allows you to hide traceability sections on the issues when no links exist for test cases, test cycles, or test plans.

config traceability svr

This section allows you to enable automatic traceability links between issues, test cases, test cycles, and test plans.

traceability links


If enabled, settings configured in the Permissions section are active for the selected project. If disabled, all users who can view the project are able to perform all TM4J actions.


To make changes, click one of the editable fields for the action you want to change, add or remove users, roles, and/or groups for the action, then click Save. Finally, refresh the page to apply the changes.


Versions are snapshots of a project over time. You can compare version to version to see changes, which can help you schedule and organize your releases.

TM4J uses the versions specified on this project setting.



Components are subsections of a project used to group issues or test cases into smaller parts.

TM4J uses the components specified in this project setting.