---
title: "Test Runs Summary Gadget"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44565378/Test%20Runs%20Summary%20Gadget"
format: markdown
---
Table of Contents
> Macro (toc)
# Introduction
The Test Runs gadget (Figure 1) provides a summary of the filtered [Test Runs](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565109), in a chart or table layout, showing the amount of Test Runs per status, grouped by a [Test](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565156) or Test Run field.
> Macro (inline-media-image)
The Test Runs gadget enables you to see the overall status of a group of scheduled/executed Test Runs (e.g., from a Test Plan) through a vertical bar chart or a table, showing the amount of Test Runs per status, grouped by a given Test or Test Run field.
Some possible usage scenarios:
- Analyzing the Test Runs from a [Test Execution](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565117).
- Analyzing the Test Runs from all Test Executions belonging to a [Test Plan](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565153).
- Depicting the Testing results for a given component, in the context of a Test Execution or Test Plan.
- Seeing how the Testing is progressing in terms of scheduled runs, from the Test Run assignee perspective.
- Seeing how the Testing is progressing in terms of scheduled runs, based on the Test priority.
- Seeing how failures or some other Test Run statuses are impacting components.
# 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 Runs Summary gadget or type it in the bar (Figure 4 - 1). Then, click *Add* (Figure 4 - 2).
>
> 
>
> > Macro (rw-step)
>
> The Test Runs Summary 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 Runs for the chart can be indirectly provided using a saved filter or selected Test Execution and Test Plans, which may be used in conjunction with Test and Test Run-specific filters:
>
> - *Saved filter or Issue* *Picker* (Figure 5 - 1): a saved filter containing Test Execution and/or Test Plans Issues or a selection of said Issues (mandatory field).
> - Test Filters:
> - *Priority* (Figure 5 - 2): priority of the Test associated with the Test Run.
> - Test Run Filters:
> - *Assignee* (Figure 5 - 3): the assignee of the Test Run.
> - *Status* (Figure 5 - 4): the status of the Test Run.
> - *Date* *range* (Figure 5 - 5): only Test Runs with start date and end date between the selected range will be considered.
> - *Group* *By* (Figure 5 - 6): group the results by the Test Run assignee, Test Run executed by, Test component, Test Key, Test Type, label, priority, and any custom field with options.
> - *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, and you can switch between a bar chart (Figure 7 - 1) or a table layout by clicking the respective button (Figure 6 - 1).
>
> 
>
> 
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).