Gauge Chart, Progress Bars & Counters Documentation
Gauge Chart, Progress Bars & Counters for Jira Dashboards is a dashboard gadget that turns one or more Jira numbers into a radial gauge, a progress bar or a grid of big-number counters. Each number — a series — is an issue count or the sum of a numeric field over a JQL query or a saved filter, optionally as a percentage of a second query. The range (Min and Max) and every target marker can be fixed numbers or live JQL results, so "% of this sprint's commitment" or "open bugs vs. last month's baseline" stay current without editing the gadget. A date range on the gadget limits every query to a period such as Last 3 months, and anyone viewing the dashboard can change it.
Everything is configured in a live-preview editor with three panels — Data, Appearance, Markers. Above the preview sit the date range and the visualization switcher.
Data & permissions. The gadget reads issues with the Jira REST API in the context of the person viewing the dashboard. Everyone sees only the issues their own Jira permissions allow. Nothing is written to Jira and nothing leaves your site.
Getting Started
- 1 Open a Jira dashboard, click Add gadget and search for Gauge Chart, Progress Bars & Counters.
- 2 On the new gadget, open the ··· menu and choose Configure. The editor opens with a live preview.
- 3 Pick a visualization with the switcher above the preview — Gauge, Progress Bar or Counter.
- 4 Open Data, click the first series and give it a JQL query or a saved filter.
- 5 Set the Minimum and Maximum, pick a date range if you need one, add threshold bands or target markers, then Save.
The Editor
| Control | What it does |
|---|---|
| Visualization switcher | Above the preview, right of the date range: Gauge, Progress Bar, Counter. Series, Min/Max and markers carry over when you switch — only the rendering changes. |
| Date range | The chip above the preview. Sets the period every query is limited to; viewers see the same chip on the dashboard. See Date range. |
| Data | Series list, the Min / Max scale and the date field the range applies to. See Data. |
| Appearance | Options specific to the selected visualization — legend, style, orientation, shape, layout — plus the colour theme and widget height. |
| Markers | Threshold bands (gauge) or target markers (progress bar & counter). See Thresholds & Markers. |
| Save / Cancel | Save writes the configuration to the gadget; Cancel discards every change since the editor opened. |
The preview is the real widget: it re-queries Jira about a second after your last change, and it is rendered at the exact height you set, so what you see is what the dashboard shows.
Data
Series
A series is one number. A gauge draws one needle per series, a progress bar one bar per series, a counter one card per series. The Data panel lists them: each row shows the series colour, its name, a one-line summary of its query and its current value. Add more with + Add Series; the bin icon removes one.
Click a row to open that series' page. ‹ Series at the top takes you back to the list.
The series page
The page asks one thing at a time, top to bottom. The value in the header updates as you type.
| Setting | Meaning |
|---|---|
| Name | Click the name in the header to rename the series. It is the legend, bar or card label. |
| Value | Fixed — a number you type. JQL — computed from Jira issues. |
| Result | Total (default) — one query, one number. Percentage — one query as a share of another; see Percentage mode. |
| Issues | The query card. Its JQL / Filter switch picks Atlassian's own JQL editor with autocomplete, or one of your saved Jira filters. An empty JQL counts every issue you can see. |
| Measure | Count of issues, or Sum of <field> for any numeric field on your site — Story Points, custom number fields, and Jira's time-tracking fields (Original Estimate, Time Spent, Remaining Estimate, and their Σ variants). |
| Dates | Shown when the gadget has a date range. Untick Use the date range to let this series ignore it — see Date range. |
Time-tracking fields sum in seconds. Jira stores estimates and time spent as seconds, and the gadget shows the raw sum. Divide by 3,600 in your head — or, if you need hours and days rendered as such, the Number widget in Plugio Suite formats durations natively.
Sums stop at 5,000 issues. A Sum has to read every matching issue, so the gadget adds up at most the first 5,000. When a query matches more, a warning icon appears next to the value and a note on the dashboard says the number is partial. Narrow the query (or use a date range) for an exact sum. Counts have no limit.
Percentage mode
Percentage mode divides one query by another. The Target card is the subset you are measuring, the Out of card is the baseline: issues resolved this sprint over issues committed this sprint, bugs with priority Highest over all open bugs. The result is a rounded whole-number percentage. A baseline of zero yields 0 rather than an error, and an empty Out of card is flagged as required.
Percentage results are shown as a plain number (42, not 42%). Set Min 0 and Max 100 so the gauge or bar reads as a percentage.
Min & Max
Minimum and Maximum, under Scale in the Data panel, bound the gauge arc, the progress-bar axis and the counter's fill. Type a number, or click Use query to compute it from Jira with the same page a series uses. A query-backed bound shows its current value; click it (or Edit query) to change the query. That makes the range itself live: Maximum = Sum of Story Points in the active sprint turns a fixed "0–100" gauge into "0 to whatever the team committed". Defaults are 0 and 100.
Date range
A gadget can limit every query to a period. The range is picked from the chip above the chart — in the editor and on the dashboard alike — and reads like Created · Last 3 months: the date field, then the period.
| Choice | Meaning |
|---|---|
| Presets | Grouped by Day, Week, Month, Quarter and Year: Last 7 days, This month, Last 3 months, Last quarter and so on. Presets roll forward on their own — This month is always the current month. A ~ marks a period that is still running. |
| All time | No date limit. This is the default, and what every gadget created before the date range existed uses. |
| Custom range | Fixed From and To dates. |
| Applies to | In the Data panel, Date range applies to picks the date field the range filters on: Created (default), Updated, Resolved, Due date, or any custom date field. With Resolved, "Last month" means issues resolved last month; issues without that date fall outside every range. |
The range is added to each query of the gadget — every series, the Minimum and Maximum, and every target marker. A query that should not be limited, such as all open bugs as a baseline, opts out with Use the date range on its own page.
On the dashboard
Viewers can change the range from the same chip to look at another period. Their choice is only for their own view and is never saved; reloading the dashboard brings back the range you set in the editor. Gadgets created before the date range existed show the chip on All time, so they can be narrowed too — their saved numbers are unchanged.
Visualizations
Gauge
A radial dial with one needle per series on a shared Min → Max arc. Threshold bands colour the arc; scale labels sit inside it at the quarter points; the legend lists each series with its rounded value.
| Appearance setting | Options |
|---|---|
| Gauge Style | Standard (a 240° arc) · Half Circle (180°, saves vertical space). |
| Legend Position | Left · Right (default) · Top · Bottom · Hide. |
| Show Ticks | Toggles the scale labels and tick marks inside the arc. |
| Widget Height | 280–700 px. The dial always fits the height exactly. |
| Color Theme | See Colour Themes. |
Progress Bar
One bar per series, all on the same Min → Max axis, with the value printed at the end of each bar. Target markers render as dashed lines with a numeric label — the classic "current vs. goal" read.
| Appearance setting | Options |
|---|---|
| Orientation | Horizontal (default) · Vertical. |
| Size | Bar thickness, 20–100 px. |
| Widget Height | 280–700 px. |
| Color Theme | See Colour Themes. |
Counter
A grid of big-number cards, one per series, filled in the series colour. Each card can carry a progress indicator toward Max — a ring on circular cards, a rising fill on square ones — and target markers as dots on the ring or "waterlines" on the fill. Markers turn to their "reached" style once the value passes them; hovering a marker shows its value.
| Appearance setting | Options |
|---|---|
| Shape | Circle (ring + dot markers) · Square (fill + line markers). |
| Show Progress | Toggles the ring / fill. |
| Show Markers | Toggles marker dots / lines. Off by default for counters. |
| Show Labels | Series name under each value. |
| Layout | Rows × columns picker up to 5×5, or Auto — the grid picks the arrangement that gives every card the most room. Extra series always get a row; the grid never drops a card. |
| Widget Height | 280–700 px. Cards resize to fill. |
Thresholds & Markers
The Markers panel changes with the visualization.
Gauge — threshold bands
A contiguous list of ranges over the arc, each with a colour. The start of every band is the end of the previous one (the first starts at Min) and is shown read-only — you only edit ends. New gadgets start with four bands: green to 25, yellow to 50, orange to 75, red to 100. Anything above the last band's end is drawn neutral, so an out-of-range value is visible as such.
Order the colours to match the meaning: green→red for "low is good" (open bugs), red→green for completion. The direction comes from your colour order.
Progress bar & counter — target markers
The Markers panel lists the markers the same way the Data panel lists series; click one to open its page. Each marker is a colour plus a value, and the value is a fixed number or a live JQL / saved-filter result with its own measure. A marker at Count of issues in the sprint keeps the sprint goal moving with the sprint. On the bar, markers are dashed lines with a label; on counters, ring dots or waterlines. Markers are shared by all series in the gadget.
Marker colours: Green, Light Green, Yellow, Orange, Red, Dark Red, Blue, Purple, or a custom colour.
Colour Themes & Sizing
| Setting | Meaning |
|---|---|
| Color Theme | Ten-colour palettes assigned to series in order: Basic (default), Pastel, Dark, Neon, Sunset, or a Custom theme — pick one colour and a ten-step monochromatic palette is generated from it. Counter text flips between dark and white automatically for contrast. |
| Widget Height | 280–700 px in 20 px steps, per visualization. This is the one size control: the chart always fits the height exactly and reflows with the gadget's width. |
| Light / dark | Backgrounds, text and gridlines follow Jira's theme automatically. Series and marker colours are the ones you chose. |
Values are rendered as rounded whole numbers with locale thousands separators. There is no prefix, suffix or decimals setting — the gadget stays minimal on purpose.
Troubleshooting
The gadget shows "No Data"
No series has a value yet, or the Min/Max query failed. Open the editor and check that every series row in the Data panel shows a number, then open the series and look at its query — Jira rejects queries with a syntax error or a field it doesn't know.
The number differs from a filter I ran
The gadget runs as the viewer, so someone without access to a project sees fewer issues. Also check the Measure: Sum of a field skips issues where the field is empty. And check the date range on the gadget: the chip above the chart limits every query unless a series opts out.
A value has a warning icon
It is a Sum over more than 5,000 issues, so only the first 5,000 were added up. Narrow the query or pick a date range. See The series page.
Time-tracking sums look huge
They are in seconds. See the note under The series page.
Data isn't refreshing
The gadget queries Jira when it loads. Reload the dashboard for fresh numbers.
Support
Questions, feedback or a feature request? We answer fast.
Email: [email protected]