Configure JIRA Defects

Configure Defect Integration with JIRA

After connecting qTest Manager and JIRA, you must configure defect integration with JIRA to provide developers with comprehensive details from test execution, such as the steps to reproduce and the environment.

The setup steps in this article will help you determine the JIRA issue type the defect will represent and the JIRA fields that will be auto-filled when submitting a defect. 

To configure defect integration with JIRA, you must have the following permissions.

  • qTest Manager Project Administrator permissions to access the project’s integration settings.
  • The JIRA username in the connection must have ‘Create Issue’ permission in the JIRA project.  For more information, refer to the JIRA article Manage Project Permissions.


  • You can setup your qTest Manager project to be able to submit defects into multiple JIRA projects.  If so, the JIRA project will be selectable when the defect is logged by the tester.
  • You can select multiple JIRA issue types (such as Bug or even custom issue types) to be mapped as Defects.  Mapped JIRA issues will be referred to as "Defects" in qTest Manager.
  • qTest Manager requires that at least one JIRA issue is mapped as a Defect.

To configure defect integration with JIRA, perform the following steps.

  1. From the Configure Connection page, click the Add Defect Type button.  

    The Add Issue Type pop-up window displays.

  2. Click the down arrow to the right of The JIRA project field.  From the drop-down list, select the JIRA project in which to submit the defect.  
  3. Click the down arrow to the right of the JIRA Issue types field.  Select the applicable JIRA issue type from the drop down list.  The selectable issue types in this field automatically show the issue types that are available in this JIRA project.  The Bug issue type is a very popular choice, but you can also select other issue types, such as tasks or even custom issue types that exist in the JIRA project.
  4. Click the OK button.  The Defect Integration section displays the JIRA project and JIRA issue type you selected.

Auto-Fill Defect Fields

To automatically fill in JIRA fields when submitting a defect, use the Defect Auto Fill feature as follows.  Position the arrow cursor in the ACTIONS field of the new line created in the Defect Integration area.  Two icons are displayed, as shown in the following screenshot.  Select the first icon, the wrench.    

The Edit Auto Filling instructions vary depending on whether you are connected to JIRA Cloud or JIRA Server.  More details are provided below.

JIRA Cloud Auto-Fill

This screen allows you to select the JIRA defect fields to auto-fill using qTest Manager field values.  When you create a defect in qTest Manager, the information you select on the Edit Auto Filling screen is automatically populated in the JIRA “Create Issue” window.  The tester need not manually enter the information in JIRA.  

  1. Select the fields you want to auto-fill on the JIRA defect.

    HINT: The auto-filling of defect fields is optional, but highly recommended to save time and provide more information from the qTest Manager test.

  2. Select the values to auto-fill.  For example, click the link under the Description field.  The Edit Field screen is displayed.

  3. In the Input Option field, you can either select the Auto Fill option button or the Default Value option button.  

    • Selecting the Auto Fill option means the data are taken from qTest Manager and dynamically filled into JIRA.  Selecting the Default Value option means the JIRA field will always fill with the same pre-defined value.
    • Only fields in Text format can be auto-filled.  Other fields can be configured for Default values only (instead of dynamic auto-fill).
    • You can select multiple qTest Manager fields to auto-fill into one JIRA field.  For example, the Description of the JIRA issue can be auto-filled with Description (Test Steps), Assigned To (Test Run), and Environment (Test Run).
  4. To add additional fields for auto-fill, click the Add button and select from a list of other available qTest Manager fields, such as Assigned To (Test Run).


  5. Click the OK button.  You can add as many additional fields as you like.

JIRA Server Auto-Fill

  1. The Edit Auto-Filling form displays.  By default, qTest Manager will load all available fields of the mapped JIRA issue type to the Defect Field column.
  2. Set Auto-Filling for mapped JIRA issue's fields.  qTest Manager will auto-fill data from the Test Run or Test Case into the mapped JIRA issue's field as settings.
  3. Drag available qTest Manager Test Runs fields and drop to the corresponding JIRA fields in the Auto-Filled With column.

  4. Click the OK button to complete the Auto-Filling configuration.


See the following articles


Subscribe To Our Blog
Powered by Zendesk