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

> Macro (toc)
</details>

# Introduction

The Test Plans List is a gadget for viewing the [Test Plans List Report](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565205) for a set of [Test Plan](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565153) Issues, which can span different projects.

![Figure 1 - Test plans list](media://4a636f0e-e641-4bc3-903c-bcc774e10a47)


This gadget provides a quick way of evaluating the current status of your project's Test Plans. You can visually identify the Test Plans by filtering them beforehand, and determine their overall status based on all the associated Tests.


> ℹ️ 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://561069a8-763f-4eb6-8e5d-3673323d4fc5)
> 
> > 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://3197091d-84e1-4d11-9b48-1063016acc8e)
> 
> > Macro (rw-step)
> 
> A side menu will open on the right (Figure 4). Search for the Test Plans List gadget or type it on the bar (Figure 4 - 1). Then, click *Add* (Figure 4 - 2).
> 
> ![Figure 4 - Add](media://965c4778-2dee-42c2-a302-55b08d37de00)
> 
> > Macro (rw-step)
> 
> The Test Plans 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 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.
> - *[Test Environment](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565129)* (Figure 5 - 4).
> - *Final Status* Precedence (Figure 5 - 5):** **whether the final status has precedence over non-final ones.
> - *Auto-generate gadget name *(Figure 5 - 6)*:*** **whether the name of the gadget should be generated based on the parameters you defined.
> 
> ![Figure 5 - Dashboard.png](media://7a6f419b-8ae2-409d-a035-bb4f4e2b5500)
> 
> > Macro (rw-step)
> 
> Once you're done configuring, click *Save* (Figure 5 - 7).
> 
> The output will appear immediately (Figure 6).
> 
> ![Figure 6 - Dashboard.png](media://55309ac1-238b-4d6d-b2b9-74cff1453efc)


<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>