Using the Defects Module


The Defects module is where users can create, view, and edit defects that have been created within the internal defect tracker.  qTest Manager's internal defect tracker is simple, yet powerful, allowing you to manage defects in real-time as they are raised.

External Defects

If your qTest Manager project is integrated with an external tool like JIRA, Rally, or VersionOne, the Defects module will disappear within your project.  This is because the external defects reside in the external tool.  To easily view any external defects that are linked to scripted tests in your project, please see these areas in Test Execution.

  • Defects Summary of Release, Test Cycle, and Test Suite                                                                                                                                                                                                               
  • Defects tab of Test Run                                                                                                                    

Create an Ad-hoc Defect

If you find a defect outside your scripted testing activities, you can create a new defect that is not linked to any test runs.  A defect created in this manner is considered to be an "ad-hoc defect." 

To create a new ad-hoc defect, follow these instructions:

  1. Go to the Defects module.
  2. Click the New Defect button to open a New Defect Submission Form.
  3. Fill out all required and necessary fields in the Details section.
  4. Enter the Description and add Attachments for the Defect.
  5. Click the Save or Save & Close button.


  • When creating a new defect, the Comments box is disabled.  If you want to comment on a defect, you can do so on any existing defect (or refresh the page after you create the defect).
  • The Linked Test Runs section of a defect is in "read-only" mode.  Any defects created ad-hoc will not be linked to any Test Runs by default.  If you would like to manually link an existing defect to a test run afterward, you can do so from the Test Run page.  Then, you will be able to see the linked test run information in the Linked Test Runs section of the defect.  Defect_Submission_Form.png

Import new defects using Excel 

To save time, you can import defects from an Excel spreadsheet.  This can be useful to create a number of defects at one time rather than creating them one-at-a-time through the user interface.  This functionality can be used for projects that are not integrated with an external tool like JIRA.  To create new defects using Excel, perform the following steps:

  1. Select the Defects module and click the Import Excel Data icon in the left panel, on the right side of the panel.  
  2. The Import Defect Wizard Beta screen is displayed.  Click the Sample Import Template link to download this sample file.  

    A sample spreadsheet is displayed that shows you the format your spreadsheet should be in and the fields you can import to qTest Manager.  The sample template also provides “dummy” data to show you the type of information you can include in your own spreadsheet.  

  3. Using the sample template as a guide, create your own Excel spreadsheet making sure to use the same column names, with one exception.  Do not include a column for the Defect ID when importing a new defect.  (See Column A in the screenshot shown above.)  When you create new defects using an Excel spreadsheet, qTest Manager will automatically generate a Defect ID for each new defect.

    HINT: If you want to import defects with custom fields, make sure to first create the custom fields in qTest Manager from Field Settings and then insert the custom fields in your spreadsheet.  When finished, save the spreadsheet in your directory.  
  4. On the Import Defect Wizard Beta screen, click the link that reads ‘click here to pick from a folder’ and select the applicable Excel file from your local drive. 

  5. Click the Next button.  The Import Defect Wizard Beta screen is displayed.  The column names from your Excel spreadsheet are displayed in the Available fields for mapping area at the top of the screen.  
  6. Drag and drop each column name from the top area of the page to the Imported Spreadsheets Columns area of the screen to the row in the Imported Spreadsheet’s Columns area next to the corresponding qTest Defect Field.  For example, drag and drop the Summary column name in the ‘Available fields for mapping’ area to the Imported Spreadsheet’s Columns row to the right of the Summary qTest Defect Field.  

    HINT: If you do not see the column names you expected at the top of the screen, make sure the top header is the column name on your Excel spreadsheet and ensure the ‘Use imported files first row as header’ checkbox is selected.

    IMPORTANT: Mapping is required for all qTest Manager Defect fields that are followed by a red asterisk.  If you do not wish to have those fields be required for import, simply un-toggle the required radio button in the Field Settings area of your project. If columns mapped to required fields contain no values, the system will generate an error message indicating an unsuccessful import.  If columns mapped to non-required fields contain no values, these fields will be imported into qTest Manager with either blank data or default values you define in your project’s Field Settings.

  7. When finished mapping all fields, click the Import button.  The defects will be created within qTest Manager with the information from the Excel spreadsheet.  qTest Manager will also assign a Defect ID to each defect.  A pop-up is displayed which indicates the number of new defects that have been added to qTest Manager.  

  8. Click the OK button.

Modify existing defects using Excel 

The Import Defect Wizard can also be used to update defects that already exist in qTest Manager.  The steps to modify existing defects are the same as the steps to import new defects into qTest Manager with two exceptions.  

When modifying existing defects using Excel you must create a column in the Excel spreadsheet for the Defect ID so that when the spreadsheet is imported, qTest applies the updated information to the correct defects.  The Defect ID assigned to each existing defect in the selected project in qTest Manager is displayed in the ID column, as shown in the following screenshot.

Clone a Defect 

The Clone Defect function is used to quickly make a copy of an existing defect. To use this function, you must have Create Defects and Edit Defects permissions. 

  1. Open an existing defect you want to copy and click the Clone button.  The details of the original defect are copied to the cloned defect. Note that a cloned defect has a status of ‘New’. 


  1. Test runs associated with the original defect, Attachments, Comments, and History are also not copied from the original defect to the cloned defect.
  2. Edit any details in the cloned defect, as needed and then click the Save button to save the cloned defect.  Click the Save  Note that a cloned defect has a status of ‘New.’     
Powered by Zendesk