Add Vansah gadgets to a Jira dashboard to keep testing progress and traceability reports together. Each gadget has its own configuration, so you can show different Jira spaces, Test Folders, work items, or Test Plans on the same dashboard.
Before you begin
Use a Jira dashboard that you can edit. Ask its owner for access if editing is unavailable.
Vansah must be installed on the Jira site with an active license. You need access to the Jira spaces and testing information you want to report on.
Choose a gadget for your question. See Find and Use Vansah Reports for help selecting one.
Changes to a shared dashboard are visible to its other viewers.
Add a Vansah gadget
In Jira, open Dashboards and select the dashboard you want to use.
Select Edit to enter dashboard editing, then select Add gadget.
Search for Vansah.
Select Add beside the gadget you want, such as Vansah - Test Summary Report or Vansah - Test Execution Report.
Close the gadget picker and find the new gadget on your dashboard.
The screenshot shows the gadget search. Its older Issue Traceability names correspond to the Requirements Traceability Matrix and Requirements Traceability Summary names in the current gadget list.
For help with Jira’s dashboard controls, see Atlassian’s Add and customize gadgets.
Configure and save the gadget
Open the new gadget’s configuration. If it is already displaying a report, open its More actions (…) menu and select Configure. Enable dashboard editing first if needed.
Select the Jira space or spaces requested by the gadget.
Select the reporting scope and complete the required fields. Use the table below to decide what to include.
Set the date range or grouping when the gadget provides those options. Use More + to choose additional filters, then select their values.
Select the gadget’s Save button. Wait for the report to load and check that it shows the intended data.
When you finish arranging the dashboard, select Jira’s Done button if it is shown.
Gadget scope | What to select |
Work items or requirements | Choose the relevant work items using the offered list, JQL, or saved Jira filter. |
Test Folders | Choose the Jira space and Test Folders you want to include. |
Test Plans | Choose the Test Plans and the relevant iterations offered by the configuration. |
Execution or assignment reports | Review the available scope, date, grouping, and assignee choices for that gadget. |
The required choices vary by gadget. If Save is unavailable, complete its required selections. Adding a filter field alone does not choose a value for that field.
Change the report later
Open the gadget’s More actions (…) menu and select Configure.
Review its Jira spaces, reporting scope, and filter values. Recheck space-specific values after changing the selected space.
Make your changes and select the gadget’s Save button.
See Filter Vansah Reporting Gadgets, Filter Gadget Work Items with JQL, or Restore a Gadget’s Saved Configuration for more detailed instructions.
If setup does not work
Problem | What to check |
Vansah is missing from the gadget picker | Confirm you are on the Jira site where Vansah is installed. Ask a Jira administrator to check the app installation. |
Editing or Configure is unavailable | Confirm that you can edit the dashboard and enter its editing mode. |
The gadget reports an invalid license | Ask a Jira administrator to check the Vansah license. |
The report has no data | Check the selected Jira spaces, work items, folders, plans, iterations, dates, and filters. For traceability reports, confirm that the relevant Test Cases are linked to the selected items. |
Changes do not appear | Reopen Configure and check the saved values. Save again if needed, then refresh or reload the gadget. |