---
title: "Tests List Gadget"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44565340/Tests%20List%20Gadget"
format: markdown
---
Table of Contents
> Macro (toc)
# Introduction
The Tests List Gadget (Figure 1) allows you to view the [Test List Report](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565196) for Test Issues, which can span different projects.
This gadget provides a quick way of evaluating the current status of your project Tests. You're able to visually identify the Tests by filtering them beforehand and determining their status.
Xray makes it possible for you to analyze the status for a given version, considering the executions 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).
>
> 
>
> > 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).
>
> 
>
> > Macro (rw-step)
>
> A side menu will open on the right (Figure 4). Search for the Test Lists gadget or type it in the bar (Figure 4 - 1). Then, click *Add* (Figure 4 - 2).
>
> 
>
> > Macro (rw-step)
>
> The Tests 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 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.
>
> 
>
> > Macro (rw-step)
>
> Once you're done configuring, click *Save* (Figure 5 - 8).
>
> The output will appear immediately (Figure 6).
>
> 
Support/Troubleshooting
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).