Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Report a defect from a failed test

Report a defect from an individual test that has failed so that you can further investigate the test failure.

Before you begin

  • The ability to report a defect is available only if the Agile Development 2.0 plugin is activated.
  • Perform tests and update the test status. For more information, see Performing tests and updating the test status.
  • Role required: tm_tester

    Important:

    Verify that the rm_tester role is assigned to you in your instance. This role is required to use the Report Defect link. If the role is not available, contact your system administrator to confirm the correct role for your organization.

About this task

Use the Test form to report a defect for a test that has failed. The reported defect is also linked to the test case which this test is related to.

Procedure

  1. Navigate to All > Test Management > Test Execution > Test Plans.

  2. Open the test plan which has the failed test.

  3. From the Test Cases related list, open the test case which has the failed test.

  4. From the Tests related list, open the test that failed.

  5. On the Test form, click one of the following links:

    • The Report Defect link next to the Status field.
    • The Report defect related link.
    • On the form, fill in the fields.
FieldDescription
NumberSystem-generated unique identifier for the defect.
Assignment groupGroup assigned to fix this defect.
Assigned toIndividual assigned to fix this defect.
PriorityPriority of the defect. Choose one from the following:- 1- Critical - 2 - High - 3 - Moderate - 4 - Low - 5 - Planning
StateThe current state of the defect. Select one from the following:- Draft - Scoping - Awaiting Approval - Work in Progress - Testing/QA - Deploy/Launch - Closed/Complete - On hold - Canceled
Short descriptionBrief explanation of the defect.
DescriptionDetailed explanation of the defect.
Work notesAny comments, notes, or other information related to the defect.
  1. Click Submit.

Result

A defect is created and added to the following related lists:

  • Defects for Test Case related list of the test case associated with the failed test.
  • Test Plan Defects related list of the test plan associated with the failed test.

What to do next

After submitting the defect, you can modify it from the defect record. The role required to modify a defect depends on your organization's configuration. By default, the defect is assigned to the group or individual specified in the Assignment group and Assigned to fields.