FAQ
General
What is Dashboard Templates, Charts, Graphs & Reports for Jira?
It is a Jira Cloud app that adds seven powerful gadgets to your Jira dashboards: Custom Charts (10 chart types), Issue List (configurable issue table), Dynamic Filter Controller (shared interactive filter bar), Time in Status (changelog-based status duration analysis), Pivot Table (cross-tabulation with 9 display types), Cumulative Flow Diagram (stacked area flow chart), and WIP Aging Charts (scatter plot for in-progress age). All gadgets update in real time as Jira data changes.
Which Jira products does the app support?
The app works with all Jira Cloud products - Jira Software, Jira Service Management, and Jira Work Management. It requires Jira Cloud; Server and Data Center are not supported.
Is there a free trial?
Yes, a 30-day free trial is available on the Atlassian Marketplace. No credit card is required to start the trial.
How do I install the app?
Go to Jira Settings → Apps → Find new apps, search for "Dashboard Templates Clovity", click Install, and accept the permissions. Gadgets are immediately available in the dashboard gadget gallery.
Charts & Configuration
How many chart types are available?
The Custom Charts gadget supports 10 chart types: Pie, Bar, Grouped Bar, Stacked Bar, Line, 2D Line, Table, 2D Table, Funnel, and Tile.
How do I change the chart type?
Open the gadget in edit mode, click the Chart Type tab in the right panel, and select your desired type. The preview updates instantly.
Can I use custom fields in charts?
Yes. Any custom field in your Jira instance can be used for Chart By, Group By, or Calculations - including custom dropdowns, number fields, and user pickers.
Why does my chart show "None" for some segments?
"None" appears when issues do not have a value for the selected Chart By field. You can rename the "None" label by clicking it, or hide it using the eye icon next to that segment.
Why is my chart showing no data?
Check three things: (1) your data source (project, filter, or JQL) returns issues in Jira's Issue Navigator; (2) you have Browse Issues permission on the project; (3) the Chart By field has values for those issues.
How do I export a chart?
In view mode (not edit mode), click the options menu (…) on the gadget and choose PNG, PDF, or CSV. If the export option is missing, your Jira admin may have disabled it globally.
Can I add a goal or reference line to a chart?
Yes. Open the gadget in edit mode, go to the Calculations tab, and click + Add Reference Line. Set the type (Goal Line or Average Line), value, and label.
Data Sources & JQL
What data sources can I use?
Each gadget supports four source types: Projects (one or more Jira projects), Saved Filter (a pre-saved Jira filter), Custom JQL (a manual JQL query), and Dynamic Filter Controller (connected to another gadget for interactive filtering).
What is a good starting JQL for a chart?
Start with project = MYPROJECT to see all issues in a project. Then narrow it with conditions like AND issuetype = Bug or AND sprint in openSprints(). Test your JQL in Jira's Issue Navigator first to confirm it returns expected results.
How do I filter by date in a chart?
Set Chart By to a date field (Created, Resolved, or Updated), then set Date Grouping (Days, Weeks, Months, Years) and Date Range in the Chart By tab. Switch Chart Type to Line for a trend view.
Dynamic Filter Controller
What is the Dynamic Filter Controller?
It is a special gadget that acts as a shared filter bar for your dashboard. Configure it once with dropdown filters, then connect your Custom Charts and Issue List gadgets to it so a single filter selection updates all connected gadgets simultaneously.
What is the Reference ID?
The Reference ID (e.g., "ABC123") is a unique code shown on a saved Dynamic Filter Controller gadget. Enter it in other gadgets when setting their source type to "Dynamic Filter Controller" to link them together.
Why aren't my connected charts updating when I use the filter controller?
Verify that each chart's Data Source is set to "Dynamic Filter Controller" and the correct Reference ID is entered. If the ID is correct, try editing the controller, saving without changes, and refreshing the dashboard with Ctrl+F5.
Can I add quick-filter tabs to the controller?
Yes. In the controller's edit mode, click the + button next to the existing tab in the Live Preview area, give the new tab a name, and set its default filter values.
Issue List Gadget
How do I add or remove columns from the Issue List?
Open the Issue List gadget in edit mode. In the Columns section, click + Add another field to add a column, drag the handle icon to reorder, and click the trash icon to remove a column.
Can I add quick filters to the Issue List?
Yes. In edit mode, scroll to the Quick Filters section and click + Add filter. Set the label and JQL condition - the filter button appears on the gadget in view mode.
Time in Status
How does Time in Status calculate time?
It reads the issue changelog - the full history of status transitions stored by Jira. When an issue moves from "In Progress" to "In Review", the timestamp of that transition is recorded. Time in Status calculates the difference between consecutive transition timestamps, giving you an accurate elapsed time for each status.
Why is my Time in Status data different from what I see on the issue screen?
The issue screen shows the current status. Time in Status shows historical time across all statuses an issue has visited. If an issue was reopened or moved backward, both trips through a status are counted.
Can I measure time in business hours only?
Yes. In the gadget's configuration panel, enable Exclude Weekends and set Work Hours Per Day to your team's working hours (e.g., 8). The calculation then counts only time within configured working days.
What is Status Grouping?
Status Grouping lets you combine multiple statuses into a single logical band. For example, if you have "Code Review", "Peer Review", and "Awaiting Approval" as separate statuses, you can group them into a single "Review" band for the report. Configure groups in the Status Groups tab inside the Time in Status gadget settings.
How do I measure time in business hours only?
Select a Business time format in the "Calculate In" setting (e.g., Business Decimal Days or Business DaysHoursMinutes). Then configure your team's work schedule - set working hours and working days in the Work Schedule page. The calculation will then exclude non-working hours automatically.
Pivot Table
How is the Pivot Table different from the Custom Charts 2D Table?
The Custom Charts 2D Table supports one field on each axis. The Pivot Table supports up to 3 fields per axis, creating multi-level nested grouping. It also offers 7 aggregation methods (vs. count-only in Custom Charts) and heatmap display types.
Can I use Story Points or other numeric fields in the Pivot Table?
Yes. Set the Aggregation Method to Sum, Average, Min, or Max, then select the numeric field (e.g., Story Points, Original Estimate, or any custom number field) as the Aggregation Field.
What is a heatmap display in the Pivot Table?
Heatmap mode color-codes each cell based on its value - darker color = higher value. You can choose to apply the color scale across the whole table (Table Heatmap), per row (Row Heatmap), or per column (Column Heatmap). Useful for quickly spotting outliers in a large matrix.
Cumulative Flow Diagram
What is a Cumulative Flow Diagram used for?
A CFD shows how work accumulates across workflow stages over time. The width of each band on any given day shows how many issues were in that stage. Widening bands indicate a bottleneck - work is entering the stage faster than it is leaving.
Can I scope the CFD to a specific sprint?
Yes. Set Date Range Mode to Sprint Range and select the sprint. The chart automatically uses the sprint's start and end dates as the time window.
What is Board Integration?
When you connect the CFD to a Jira Software board, it uses the board's column definitions as bands instead of raw statuses. This means multiple statuses mapped to the same board column appear as a single band - matching exactly what your team sees on their board.
WIP Aging Charts
What does the WIP Aging scatter plot show?
Each dot represents one in-progress issue. The X position shows how many days it has been in its current status. The Y position shows which status group it belongs to. Dots far to the right are the oldest - the ones most likely to be stalled or at SLA risk.
What is the Percentile Line?
The percentile line shows a statistical boundary for your team's current aging distribution. The 85th percentile means "85% of your in-progress work is younger than this line." This is the standard metric for a Kanban Service Level Expectation (SLE) - a data-driven commitment to your stakeholders about how fast work typically completes.
What is the Threshold Line?
The threshold is a fixed day value you set manually - typically your SLA limit or internal policy (e.g., "all P1 bugs must be resolved within 5 business days"). Any dot to the right of the threshold line is a potential SLA breach that needs immediate attention.
What does Log Scale do?
Log scale compresses the X-axis logarithmically. Useful when a few very old issues stretch the axis so wide that normal-age issues are all clustered in the leftmost 10% of the chart. Log scale makes the typical cluster readable without removing the outliers.
Security & Data
Does the app send my Jira data to external servers?
No. The app runs on Jira's native Forge platform and queries Jira's own APIs. Gadget configurations are stored in Jira's built-in Forge KVS storage. Issue data is not copied or exported to any external system.
Why can't I see certain issues in my chart?
You can only see issues you have permission to view in Jira. If some issues are missing, check your Jira project permissions and verify you have "Browse Issues" access on the relevant project.
How many issues can the app handle?
There is no hard limit, but queries returning 50,000+ issues may load slowly. For best performance, keep queries under 10,000 issues by narrowing your JQL with date filters, project scoping, or status conditions.
Who can install the app?
Only a Jira site administrator can install apps from the Atlassian Marketplace. Once installed, all users with dashboard edit access can add and configure gadgets.
Billing & Licensing
How is the app licensed?
Licensing follows Atlassian's standard Marketplace model - priced per Jira user tier. The cost scales with the number of users in your Jira instance.
What happens when the trial ends?
If you do not purchase a license, gadgets become read-only and configuration is locked. Existing data is not deleted - purchasing a license restores full functionality immediately.
Still Have Questions?
Check the Troubleshooting Guide or contact our support team at support@clovity.com. Response time is within 1–2 business days.