---
title: "Test Sets List Gadget"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44565344/Test%20Sets%20List%20Gadget"
format: markdown
---
<details>
<summary>Table of Contents</summary>

> Macro (toc)
</details>

# Introduction

The Test Sets List gadget (Figure 1) allows viewing the [Test Set List Report](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565199) for a set of Test Set Issues, which can span different projects.

![Figure 1 - Test sets list](media://a9031782-eb8f-4c54-83ff-642080203084)


This gadget provides a quick way of evaluating the current status of your project's [Test Sets](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565163). You're able to visually identify the Test Sets by filtering them beforehand, and determine their overall status based on all the Tests associated with them.

You can analyze the status of a version by considering the [Test Executions](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565117) made for that version. Alternatively, it is possible to perform this analysis by considering a specific [Test Plan](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565153); thus, you're able to evaluate the status in its context. 

> ℹ️ Please check the [Requirements Coverage Analysis page](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565185).

# Operations

## Gadget Access

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, click *Dashboards* (Figure 2 - 1) and select *Default Dashboards* (Figure 2 - 2).
> 
> ![Figure 2 - Dashboard](media://58d7ead3-e0c8-4783-8f19-8d9fd1f9be5d)
> 
> > Macro (rw-step)
> 
> Once the dashboard opens, click *Edit* (Figure 2 - 3). A new screen will open (Figure 3). Click *Add gadget* (Figure 3 - 1).
> 
> ![Figure 3 - Add](media://0019d68a-197d-4a36-b121-e3231abef02e)
> 
> > Macro (rw-step)
> 
> A side menu will open on the right (Figure 4). Search for the Test Sets List gadget or type it on the bar (Figure 4 - 1). Then, click *Add* (Figure 4 - 2).
> 
> ![Figure 4 - Add](media://5d5e7320-052e-424e-8098-0510618be4ca)
> 
> > Macro (rw-step)
> 
> The Test Sets List gadget will immediately appear on your Dashboard (Figure 4 - 3) and is ready to be configured.

## Configuring and Using the Gadget

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> Source Test Set Issues for the list can be provided by using a saved filter or by selecting a project:
> 
> - *Project or Saved Filter *(Figure 5 - 1): a saved filter or a project containing Requirement Issues. A project or saved filter must always be selected for this gadget to be used.
> - *Number of results* (Figure 5 - 2): the number of results displayed per page is up to 100.
> - *Columns to display* (Figure 5 - 3):** **the columns that will be displayed; the order of the columns in the table will be the order of the fields in the selector.
> - *[Analysis & Scope](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565185)**:* (Figure 5 - 4): *Latest*, *Version* or *Test Plan*.
> - *Test Plan Issue:* the Issue key of the Test Plan, if the Execution Scope is *Test Plan*.
> - *Analysis Version:* the version, if the Execution Scope is *Version*.
> - *[Test Environment](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565129)* (Figure 5 - 5).
> - *Final Status* Precedence (Figure 5 - 6):** **whether the final status has precedence over non-final ones.
> - *Auto-generate gadget name *(Figure 5 - 7)*:*** **whether the name of the gadget should be generated based on the parameters you defined.
> 
> ![Figure 5 - Dashboard](media://17d28979-0752-41fe-8d08-bdd2a9215da3)
> 
> > Macro (rw-step)
> 
> Once you're done configuring, click *Save* (Figure 5 - 8).
> 
> The output will appear immediately (Figure 6).
> 
> ![Figure 6 - Dashboard](media://a42aff92-d696-4fd3-b485-3bc46d8e9a93)


<details>
<summary>Support/Troubleshooting</summary>

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/XRAYCLOUD/pages/44577312).
</details>