Setup, testing, and verification
Use this guide to install the app, build a chart, and prove that the number on it matches the Jira query behind it.
1. Install
- Open the Atlassian Marketplace listing for Charts for Jira Dashboards and choose Get it now.
- Select the Jira site where the gadget should be available and approve the installation.
- Review the permission shown during installation. The app requests
read:jira-work. It does not request permission to create, edit, or delete Jira work.
2. Add and configure a chart
- In Jira, open Dashboards, choose a dashboard, then choose Edit or Add gadget.
- Search for Chart (exact counts) and add it to the dashboard.
- Enter a chart title and a bounded JQL query, such as
project = ENG AND statusCategory != Done. - Choose a field under Group by. Jira system fields and compatible custom fields appear in the same picker.
- Choose Bar or Donut, then choose Save.
The line below the chart is part of the result. It says whether the app read the complete result set Jira returned for that query.
3. Reviewer test
- In Jira's issue navigator, run a bounded JQL query whose result count you can confirm.
- Use that same JQL in the gadget and group it by Status.
- Add the values shown on the chart. The sum should equal the issue count Jira returned for the query.
- Edit the gadget, switch to Donut, save, and confirm that the same categories and total remain.
- Edit it again and select a compatible custom field. Confirm that the field values become the chart categories.
4. What proves the app is working
- Complete result: the note below the chart states that every issue Jira returned was counted.
- Limited result: if Jira signals that a result was curtailed, the note drops the completeness claim and reports what was read. The app does not present a partial count as complete.
- Permission boundary: install details show read-only Jira work access, and using the gadget does not change any issue.
- User boundary: the query runs with the viewing user's Jira permissions, so the gadget cannot reveal issues that user cannot open.
Need help?
Use the support form. Include the JQL, the number Jira showed, and the number on the chart so the result can be reproduced.