---
title: "Overall Test Results Gadget"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44565356/Overall%20Test%20Results%20Gadget"
format: markdown
---
Table of Contents
> Macro (toc)
# Introduction
The Overall Test Results (Figure 1) is a gadget that analyzes the overall Test results distribution by their status. The Test Issues can span different projects.
This gadget provides a quick way of evaluating the status of some Tests considering the results obtained in the context of a version or a [Test Plan](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565153).
Possible usage scenarios:
- Seeing the amount of Tests, by current status, for a specific Version or Test Plan (i.e. have an overview of the Tests in the context of a version or of a Test Plan).
- Analyzing the overall progress of a Test Plan.
- Analyzing the overall status of some Tests, on some specific [Test Environments](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565129).
- Analyzing how a subset of some Test cases currently is (e.g. the ones defined by some relevant criteria in a user-defined filter), in some version, or some Test Plan.
# 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 Overall Test Results gadget or type it in the bar (Figure 4 - 1). Then, click *Add* (Figure 4 - 2).
>
> 
>
> > Macro (rw-step)
>
> The Overall Test Results 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 chart 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 Test Issues. A project or saved filter must always be selected for this gadget to be used.
>
> > ⚠️ ### Using JQL filters with ScriptRunner Extended Functions
> > ⚠️
> > ⚠️ When using a saved filter that contains ScriptRunner extended JQL functions, enclose the filter name in double quotation marks. For example:
> > ⚠️
> > ⚠️ ```
> > ⚠️ filter = "My Filter Name"
> > ⚠️ ```
> > ⚠️
> > ⚠️ Using double quotation marks around the filter name ensures that the filter is correctly recognized when used in the gadget's JQL configuration.
>
> - *[Analysis & Scope](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565185)**:* (Figure 5 - 2): *Latest*, *Version* or *Test Plan*.
> - *Test Plan Key:* 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* (Figure 5 - 3).
> - *Final Status* Precedence (Figure 5 - 4):** **whether the final status has precedence over non-final ones.
> - *Auto-generate gadget name *(Figure 5 - 5)*:*** **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 - 6).
>
> The output will appear immediately (Figure 6).
>
> 
>
> > ℹ️ You can hide a specific result type by clicking the respective legend item (Figure 6 - 1) and open the set of Issues by clicking the corresponding segment of the chart (Figure 6 - 2).
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).