---
title: "Defect Traceability Report"
canonical: "https://docs.getxray.app/space/XRAY/301471384/Defect%20Traceability%20Report"
format: markdown
---
> Macro (rw-ui-expands-macro)
> 
> > Macro (rw-expand)
> 
> > Macro (toc)

# Introduction

The Defect Traceability Report shows the traceability starting from [Defects](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301504200), [Test Runs](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301502714), [Tests](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/159713077), and finally [Requirements](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301469601).

This report provides a reverse view of the traditional [Traceability Report](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301699901) by starting from defects and tracing back to the related Requirements and [Test Executions](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301474061). This report helps identify the origin and impact of [Defects](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301469601), offering a defect-first perspective for better root cause analysis and quality assessment.

Possible usage scenarios:

- Make full traceability analysis, from Defects <=> Test Runs <=> Tests <=> Requirements.
- Check which Defects have been reported through testing using the *Connected* or *Not Connected* options on *Filter Defects*.
- See the Tests and Test Runs where the defects have been reported, and analyze how those are impacting requirements.
- Analyze the Defects and related executions and Requirements in a [Test Environment](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301665065).
- See which Defects impact the Requirements of a specific version.

# Operations

## Report Access

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On the top menu of your Jira Data Center instance, click *Projects* and select a project (Figure 1 - 2).
> 
> ![Figure 1 - Access](media://b92292fa-0549-4283-973f-1b380f044a75)
> 
> > Macro (rw-step)
> 
> A menu will open on the left side of the screen. There, click *Reports* (Figure 1 - 3).
> 
> Several options will appear on the screen (Figure 1). Scroll down and click the *Defect Traceability Report* (Figure 2 - 1).
> 
> ![Figure 2 - Project](media://770cde2c-9478-4858-b185-1a88363e8048)
> 
> > Macro (rw-step)
> 
> The reports available will appear on the left side menu (Figure 3 - 1) and the screen center (Figure 3 - 2).
> 
> The Xray reports are marked with the Xray logo. Click *Defect Traceability* (Figure 3 - 2) to access the Defect Traceability Report.
> 
> ![Figure 3 - Reports](media://79a0604b-ab47-4bb1-be7f-a42622fdce5c)

## Configuring and Using the Report

When the Defect Traceability report is opened, an empty state will be displayed, and you'll have to explicitly generate the report after selecting the initial filters (Figure 4).

At the top of the report, you have some options that need to be configured:

- *Filters* (Figure 4 - 1): the source data for the report (e.g.: the Defect Issues).
- *Filter Defects *(Figure 4 - 2):* Show All*, *Connected* or *Unconnected Defects*.
- *Show Test Runs* (Figure 4 - 3): toggle the view of the Test Runs column. This impacts the export of the report in a CSV file.
- *Quick Filter* (Figure 4 - 4): choose the quick filter field.

![Figure 4 - Configuration](media://5f958350-5b87-45ff-a9c2-14c23ac97f16)

> ℹ️ - You don't have to change any of the options shown in Figure 4. You can create the report with the options configured by default.
> ℹ️ - Once you generate the report, your settings will be saved. The next time you access the report, it will be populated with the last filters you configured.
> ℹ️ - Once the report is generated, changes to the Filters, Filter Defects, and the Test Runs toggle will be applied automatically, and the report will be regenerated.

### Filters

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
>  The source data for the report can be defined under *Filters *(Figure 5 - 1).
> 
> ![Figure 5 - Filters](media://f5fdb359-0733-4488-950c-cf9d2acc74fc)
> 
> Source Defect Issues can be selected using the Basic filters provided:
> 
> - *Basic* (Figure 5 - 2):
>   - *Projects*.
>   - *Fix Version*: versions assigned to the defect issues (if any).
>   - *Sprint*: sprint assigned to Requirements (only available if Jira Software is installed).
>   - *Component:* the component assigned to the Issue.
>   - *Status*: the workflow status.
>   - *Resolution*: the workflow resolution.
>   - *Contains text:* the full Issue key or part of the summary.
>   - *Saved Filters*: a saved filter containing Defect Issues.
>   - *Test Environments*: Filter defects by the Test Environment in which they were created (based on the associated Test Runs).
>   - *Test Run Fix Version*: versions assigned to the Test Run associated with the Defect Issues (if any).
>   - Test Plan: Filter defects by the Test Plan in which they were created (based on the associated Test Runs > Test Execution > Test Plan).
>   - To add more fields to the filter, you can click the *More*** **button: a modal will open for you to select any fields (Figure 6).
> - By clicking *More *(Figure 5 - 3), it's possible to manage which fields will be used to filter the Requirements (Figure 6 - 1):
>   - Selecting fields will enable further filtering of the Defects.
>   - Unselecting fields will remove them from the dialog and thus from the search criteria.
>   - Then, click *Set *(Figure 6 - 2).
> 
> ![Figure 6 - Filters](media://9b476b7e-056a-4534-b60a-7fba685dba63)
> 
> > Macro (rw-step)
> 
> Once you're done, click *Apply *(Figure 6 - 3).
> 
> > Macro (rw-step)
> 
> You can reset the filters that are displayed back to the default filters, or you can clear all the filter values (Figure 6 - 4).
> 
> Once you're finished, click *Apply *(Figure 6 - 3).

### Connected/Unconnected Defect Filter

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> When you click *Filter Defects* (Figure 7 - 1), you can choose to display:
> 
> - *All Defects.*
> - *Connected Defects*: displays only Defect Issues that were reported when executing Tests (directly associated with Test Runs).
> - *Not Connected Defects*: displays only Defect Issues that were found outside Testing (not associated with Test Runs).
> 
> ![Figure 7 - Connected Unconnected Defects.png](media://bd48d3a1-eb10-4559-9cf4-f88744e106b4)
> 
> > ⚠️ **Incompatible Filters**
> > ⚠️ 
> > ⚠️ If you select a filter such as *Test Environments*, Fix Versions, or Test Plans, only connected Defects will appear in the search results, as these filters apply indirectly to Defect Issues from Test Runs. Therefore, if you select to show *Not Connected Defects* and one of these filters, the report will not show any results.

### Toggle Test Runs

You can show/hide the Test Runs column from the report using the toggle (Figure 7 - 2). If you hide the Test Runs in the report, the Defect Issues will be connected to Tests indirectly through Test Runs, although this information is not visible in the report.

> ℹ️ The Show Test Runs Toggle (Figure 7 - 2) impacts the export of the report to CSV. Test Runs will only appear in the exported CSV file if they are not hidden in the report.

**Quick Filter**

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> You can further filter the report by using the configured quick filter. The *default* quick filter is the priority field on Defect Issues. You can configure which quick filter to use using the report configuration button (Figure 8 - 1).
> 
> ![Figure 8 - Quick Filters](media://6bc61c65-f118-49cb-b0fc-f870a76e0e6e)
> 
> The available fields to configure as a quick filter are:
> 
> - *Priority (*default).
> - *Issue Type.*
> - *Status category.*
> - *Resolution.*
> - *Project.*
> 
> Any other Custom Field that is a select field, which has fewer than 10 options configured.
> 
> > Macro (rw-step)
> 
> Once you're finished, click *Generate Report* (Figure 8 - 2) to create the report.
> 
> > Macro (rw-step)
> 
> Once the report is generated (Figure 9), you can apply a quick filter by selecting one or more options (Figure 9 - 1). 
> 
> The report data will filter accordingly.
> 
> ![Figure 9 - Quick Filters](media://5ffbd115-d7c1-4ce8-9902-0fc4c42c6213)

### Exporting to CSV

Once the report is generated (Figure 10), you can export the report into a CSV file by clicking *Export* (Figure 10 - 1) and then selecting *To csv *(Figure 10 - 1). You will get the file instantaneously on your machine.

Exporting to CSV considers if the *Show Test Runs* option (Figure 10 - 2) is disabled/enabled.

![Figure 10 - Export to CSV](media://b7c7426a-1604-45ff-8320-701f8644f5e4)

# Understanding the Report

The Issues and values that are shown in the report (Figure 10) consider the options selected for analysis, namely, the relevant Test Executions and corresponding Test Runs, and Defects.

The report not only shows the traceability between entities but also presents some calculated values for the selected options. For example, the Requirement status and the Test status are shown in the Requirements and Tests columns, respectively.

| Column | Description |
| --- | --- |
| Defects | Defects directly associated with the Test Runs |
| Test Runs | Test Runs and their status from all related Test Executions (only three are shown, but an action allows you to see all of them) |
| Tests | Tests and the calculated status, considering the options selected for analysis |
| Requirements | Coverable Issues (e.g.: Requirements) and the calculated coverage status, considering the options selected for analysis |

# Report Performance

In Continuous Integration scenarios, with thousands of runs, showing all those Test Runs at the same time in this report may take some time and overload your browser, and it will be hard for you to analyze the report with all that information.

Therefore, we advise you to hide the Test Runs column using the toggle (Figure 10 - 2) in the report if the number of Runs is considerably high (e.g. > 1000).

> Macro (rw-ui-expands-macro)
> 
> > Macro (rw-expand)
> 
> If you have questions or technical issues, [please contact the Support team via the Customer Portal (Jira service management)](https://jira.getxray.app/servicedesk/customer/portal/2/user/login?destination=portal%2F2%2Fcreate%2F28) or [send us a message using the in-app chat.](https://getxraydocs.atlassian.net/wiki/spaces/XRAY/pages/301501383)