Docs / Insights
Report Builder
A report builder. Drag charts, tables and metric cards onto a canvas, drawing on stories, epics, features, time entries, sprints and milestones.
When to use it
When the standard reports do not answer your question.
Start here
Click "New Report" and drag in your first widget.
How to use it
- Click "+ New Report". A report named "New Report" is created and opens in the builder. Reports you made earlier appear as cards you can click to reopen.
- Rename the report by typing in the name field at the top of the builder.
- Drag a widget from the "Widgets" list on the left onto the canvas. The choices are "Bar Chart", "Line Chart", "Pie Chart", "Table" and "Metric Card" (a single number).
- Click the widget on the canvas to open "Configure Widget". Set its "Title", "Chart Type", "Data Source", "Group By", "Aggregate", "Sort Direction" and "Limit". Pick "Total (no grouping)" under "Group By" for one overall figure, such as a grand total.
- Choose "Sum" or "Average" under "Aggregate" to reveal "Aggregate Field", then pick the field to total, such as Story Points or Hours. "Count" needs no field.
- Click "Save Widget" to apply your changes, then "Save" in the top bar. "▶ Run Report" runs the saved report, so save before running.
- Click "Share" to get a link anyone can open to view the report read-only. Use "Revoke Access" in that window to turn the link off.
- Click "Reports" at the top left to return to the list, or "Delete" and confirm to remove the report.
Good to know
- Data Source choices are Stories, Epics, Features, Time Entries, Sprints and Milestones. The "Group By" choices change with the source, for example Status, Priority, Stream, Epic or Assignee for stories.
- Aggregate Field choices: Story Points for stories, Estimated Points for epics, Hours for time entries, and Total Points or Velocity for sprints. Features and milestones have none, so use "Count" there.
- "Limit" accepts 1 to 100. A new widget starts as a count of stories grouped by status, sorted descending, with a limit of 20. A new Metric Card starts on "Total (no grouping)".
- Widgets show "Click "Run Report" to load data" until you run the report. A widget with nothing to show says "No data", and one that fails shows its error.
- Groups by Stream, Epic, Feature, Assignee or Team Member show names; none set reads "No stream", "Unassigned" and so on. Stories counted include those without an epic. A grouped Metric Card shows one group's value and name: the largest, or the smallest when sorted ascending.
Related
Last updated 6 October 2026