---
title: "Coverable issues"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566418/Coverable%20issues"
format: markdown
---
> Macro (toc)


A coverable (i.e., testable) issue is one whose issue type is configured at the project-level settings to be handled as coverable issue type. These issues can be covered/validated by Tests (either manual or automated). Tests can then be organized (i.e., in Test Sets), planned (i.e., in Test Plans) and executed (i.e., in Test Executions). <span style="color: #333333">The results obtained for the linked Tests will affect the calculation of the test coverage status of the covered issue.</span>

Typical examples include Epic and Story, but your project administrator can define exactly which types can be handled in this way. For more info, check out<span style="color: #333333"> </span>[Project Settings: Test Coverage](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44566845)<span style="color: #333333">.</span>


![image](media://0cd1b071-4208-4e06-a66d-ab1e742a4da0)

### Test Coverage View 

The Test Coverage view shows all tests associated with the Covered Issue (e.g., Story, requirement) and their respective status for the chosen analysis scope. In this view, you can create a new Test and associate it with the Covered Issue or just associate an already existing Test with it.

![image](media://011f4624-4190-4276-9141-ab1e222082c4)

### Test Coverage Analysis

Within this section, the status of the covered issue and of the linked Tests can be analyzed from multiple perspectives/scopes.

As an example, a user story aimed for version 3.0 may be analyzed from the point of view of the executions made for version 3.0 or for the ones made afterwards (version 4.0). You can take into account the Tests and Test Executions linked to some Test Plan. On the other hand, if you don't care about exact versions and just want to see the calculated statuses based on the latest runs, you can use analysis by "Latest". Another analysis dimension is the Test Environment; if chosen, then only the statuses of the executions made for that Test Environment are considered.


Please read [Coverage Analysis](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565185) for a more detailed explanation on how to perform coverage analysis and where you can perform it for the different entities.


> ℹ️ **Learn more**
> ℹ️ 
> ℹ️ The calculation of the Test status or the coverage status for an issue is explained in-depth in [Understanding the calculation of coverage status and the status of Tests](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565101).

> ℹ️ **Note**
> ℹ️ 
> ℹ️ The analysis scope chosen by the user will be stored in the user preferences, the saved analysis scope will be used in all issues of the project for that user.

#### Latest

![image](media://f32249ff-ef89-4f0c-9388-fba09ee99411)

#### Version

You can see the Coverage Status for each version.

![image](media://1efd4932-7602-4a4a-9789-4f581dabe3ea)

#### Test Plan

You can see the Coverage Status for each of the Test Plans. 

![image](media://852ed02d-2eeb-4925-a0aa-674cab05aff2)

#### Test Environment

You can see the status of each Test based on the Test Environment you specified in this option.

![image](media://eb04515a-69c5-4ae6-9202-d511d48e71de)

### Actions

#### Create new Test

To create a new Test from the Requirement:

> Macro (legacy-content)

#### Associate with an existing Test/Test Set

To associate an existing Test/Test Set with the Requirement:

> Macro (legacy-content)

                                

#### Create new Test Execution / Sub-Test Execution

To create a new Test Execution from the Covered Issue, containing all linked Tests:

> Macro (legacy-content)

To create a new Sub-Test Execution from the Covered Issue, containing all linked Tests:

> Macro (legacy-content)