A report of Stories completed over a 8-week period


The Reports page helps you visualize activity across Stories, Epics, Milestones, Projects, Iterations, and Labels. Reports can only query data for up to 100 days (or a quarter), but the timeframe within that limit is entirely customizable. Screen_Recording_2019-09-05_at_02.44_PM.gif

How to Set A Custom Timeframe

You can choose to review activity between any two dates of your choosing by clicking on the "Date Range" drop-down menu and selecting your desired start and end dates.


Please note that dates on your Reports page reflect your Organization's UTC offset, which can be configured via Settings (gear wheel) > Workspace Settings > General Settings. 

How to filter Reports

You can filter the Reports page by selecting all or certain Projects, Epics, Milestones, Iterations, and/or Labels. You may also quickly remove all filters by clicking Clear Filters button to the far right of the filters.


How to group reports by time

Additionally, reports can be Grouped by Day, Week, Month and even Iterations. This allows you to better visualize velocity within time-boxed periods.


How Reports are Generated

Stories that are included in the Reports page are ones that have been moved into a "Done" workflow state. You can review your Workflow States by clicking on Settings (gear wheel) > Workflow. More on how to define your Organization's Workflow here.  

Archived stories are not included within any Reports.

If a Story is moved to a "Done" workflow state and subsequently moved back, it will not be accounted for on the Reports page. Once it is moved back into a "Done" state, it will only show up in the Report for the final/updated date range.

Note: If you are using the Clubhouse API to manually override the time/date a Story was completed, this override will be respected by Reports within the UI.  

Sections of the Reports page

Story and Epics completion Summary


You should immediately notice the Story & Epic completion summary after a report is generated. The number of stories completed are shown to the left, with the Story type breakdown immediately next to it. We specify which Story types accumulated their respective number of points. The next panel summarizes the number of Epics that were finished and the number that were updated. 

Velocity Chart

Upon generating a report with the desired date range and filters discussed above, a velocity chart will be populated. The Velocity chart is a great tool to measure the pace at which teams are completing work day by day within the specified date range. This is calculated by the number of Stories completed, broken down by type.


A table of Stories completed in the specified date range is provided directly below the velocity chart. You can click on a Story to quickly view it from the reports page without losing access to the generated report.

Epics Progression Section

The bottom section of the Reports page breaks down how Epics have progressed (through the stories completed and/or added) within the specified date range.


Progress is measured in percentages according to how many associated Stories were completed within the date range of the report. An Epic's progress is calculated not only by the number of Stories completed, but also by the number of Stories that may have been added to the Epic (as these two events change how far you are from completion).

Clicking on an Epic in this section will take you directly to view that Epic, its associated Stories, and its own reports. For more information on the reports within an Epic, see our guide on the Epic’s Report Tab.


Want to see Reports in action? Explore our Sample Workspace, which contains pre-filled information that will allow you to see how it all works together. Access it by clicking on your User Icon on top right > Help / Feedback > Sample Workspace.