--- title: "Reporting using Gadgets" canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566250/Reporting%20using%20Gadgets" format: markdown --- > Macro (rw-ui-expands-macro) > > > Macro (rw-expand) > > > Macro (toc) # Introduction Xray provides built-in gadgets for Requirement Coverage reporting. Xray’s gadgets empower users to monitor and analyze Test coverage, execution, and results directly from [Jira dashboards](https://www.atlassian.com/software/jira/guides/reports-dashboards/overview). These gadgets provide actionable insights and enable teams to visualize key metrics in real-time, enhancing collaboration and decision-making. By integrating these gadgets into Jira dashboards, Xray users can: - Gain real-time visibility into Test coverage and execution progress. - Identify gaps and prioritize Testing efforts effectively. - Monitor project health and readiness for release. - Facilitate collaboration by sharing clear, visual data with stakeholders. # Built-in Gadgets ## [Overall Test Coverage Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565335) - Displays the overall coverage of requirements by [Tests](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565156). - Provides a quick overview of how well Requirements are covered, highlighting areas that need additional Testing to ensure full coverage. ## [Tests List Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565340) - Shows a customizable list of Tests based on filters such as Status, Priority, or Type. - Enables teams to focus on specific Tests, such as those that are failing or have high priority, ensuring efficient resource allocation. ## [Test Sets List Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565344) - Displays the status of Test Sets and their associated Tests. - Helps users track the progress of grouped Tests, ensuring that all Tests within a [Test Set](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565163) are completed and meet quality standards. ## [Test Execution List Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565348) - Lists recent or ongoing [Test Executions](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565117). - Provides visibility into execution progress, allowing teams to quickly identify incomplete or failed Test Executions and take corrective action. ## [Test Plans List Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565352) - Provides an overview of [Test Plans](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565153) and their statuses. - Helps teams monitor planned Testing efforts, ensuring alignment with project timelines and objectives. ## [Overall Test Results Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565356) - Summarizes Test results (e.g., PASSED, FAILED, BLOCKED) across the project. - Offers a high-level snapshot of Test outcomes, helping stakeholders evaluate project health and readiness for release. ## [Tests by Test Type Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565362) - Groups Tests by their Type (e.g., Regression, Performance, Functional). - Enables teams to ensure balanced Testing efforts across different Test Types, aligning with project and business priorities. ## [Requirements List Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565368) - Displays a list of Requirements and their coverage status. - Highlights which Requirements are covered, partially covered, or not covered, helping teams prioritize Testing efforts to meet project goals. ## [Test Runs List Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565374) - Lists individual [Test Runs](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565109) with details such as Status and [Environment](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565129). - Offers granular insights into Test execution, helping teams pinpoint and address specific failures or inconsistencies. ## [Test Runs Summary Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565378) - Summarizes Test Run statuses over a defined period. - Provides a time-based view of Testing performance, making it easier to track progress and identify trends or recurring Issues. ## [Test Evolution Gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44566226) - Visualizes the progress of Tests and their statuses over time. - Helps teams assess historical testing trends, identify bottlenecks, and measure improvements in Testing efforts. # Operations ## Gadgets Access Consider the example below, of the Test Evolution gadget, to see how to add a Jira Dashboard gadget. > ℹ️ The Test Evolution gadget is a [Jira Dashboard gadget](https://support.atlassian.com/jira-cloud-administration/docs/use-dashboard-gadgets/). See here [how to configure Jira Dashboards](https://support.atlassian.com/jira-cloud-administration/docs/configure-dashboards/). > Macro (rw-ui-steps-macro) > > > Macro (rw-step) > > On your Jira Cloud instance, under *Dashboards* (Figure 1 - 1) and click *View all dashboards* (Figure 1 - 2). > > ![Figure 1 - Dashboards](media://09888a87-bf26-484c-906f-ad7481beb1c5) > > > Macro (rw-step) > > Click *Default dashboard *(Figure 1 - 3). > > > Macro (rw-step) > > Once the dashboard opens, click *Edit* (Figure 2 - 1). > > ![Figure 2 - Edit](media://5cd9ddb2-bd31-413b-969f-d7bb182609ff) > > > Macro (rw-step) > > A new screen will open (Figure 3). Click *Add gadget* (Figure 3 - 1). > > ![Figure 3 - Add](media://7dd54aa9-1e19-496a-bf42-6b8fb7f72f06) > > > Macro (rw-step) > > A side menu will open on the right (Figure 4). Search for the Test Evolution gadget or type it in the bar (Figure 4 - 1). Then, click *Add* (Figure 4 - 2). > > ![Figure 4 - Search](media://3d0dcbb3-a5ec-45b5-beb3-6b84c99d13c9) > > > Macro (rw-step) > > The Test Evolution Gadget will immediately appear on your Dashboard (Figure 5 - 1) and is ready to be configured. > > ![Figure 5 - Dashboard](media://d2d297f5-fee5-41a2-a6dd-d1a886f337b4) > > > > ⚠️ There’s a limit on the number of gadgets you can add to a dashboard. If you reach that limit, you will see a message (Figure 6 - 1). > > ⚠️ > > ⚠️ ![Figure 5 - Error](media://5e4c566d-f229-4bb1-aa50-7559b7660224) ## Gadget Actions ### Changing the Highlight Color > Macro (ui-steps) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Configuring a Gadget > Macro (ui-steps) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Duplicating a Gadget > Macro (ui-steps) > > > Macro (legacy-content) > > > Macro (legacy-content) ### Deleting a Gadget > Macro (ui-steps) > > > Macro (legacy-content) > > > Macro (legacy-content) > > > Macro (legacy-content)
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).