--- language: "en" --- # Great Gadgets Documentation ## Great Gadgets Documentation Welcome to the documentation space of Great Gadgets app for Jira \& Confluence. ### News * #### [How to Create a Sprint Burndown in Jira That Includes Sub-Tasks](https://documentation.stonikbyte.com/great-gadgets/how-to-create-a-sprint-burndown-in-jira-that-includes-sub-tasks.md) November 03, 2025 * #### [How to Visualize Linked Issues and Their Status in Jira Dashboards](https://documentation.stonikbyte.com/great-gadgets/how-to-visualize-linked-issues-and-their-status-in-jira-dashboards.md) November 14, 2025 * #### [How to Track Total or Average Time In Status in Jira Dashboards](https://documentation.stonikbyte.com/great-gadgets/how-to-track-total-or-average-time-in-status-in-jira-dashboards.md) December 10, 2025 * #### [What is Great Gadgets?](https://documentation.stonikbyte.com/great-gadgets/what-is-great-gadgets.md) * #### [How to install and configure Great Gadgets](https://documentation.stonikbyte.com/great-gadgets/how-to-install-and-configure-great-gadgets.md) * #### [How to use Great Gadgets](https://documentation.stonikbyte.com/great-gadgets/how-to-use-great-gadgets.md) #### [Gadgets offered](https://documentation.stonikbyte.com/great-gadgets/gadgets-offered.md) * #### [Advanced Edition Features](https://documentation.stonikbyte.com/great-gadgets/advanced-edition-features.md) #### [Migration Steps](https://documentation.stonikbyte.com/great-gadgets/migration-steps.md) * #### [Data Residency](https://documentation.stonikbyte.com/great-gadgets/data-residency.md) * #### [Technical Notes](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md) * #### [Release Notes](https://documentation.stonikbyte.com/great-gadgets/release-notes.md) * #### [FAQ - Frequently Asked Questions](https://documentation.stonikbyte.com/great-gadgets/faq-frequently-asked-questions.md) #### [Use Cases](https://documentation.stonikbyte.com/great-gadgets/use-cases.md) --- language: "en" --- # Advanced Edition Features The **Advanced Edition** of **Great Gadgets**provides enhanced capabilities, priority support, and expert guidance to help teams get the most value from their Agile reporting and dashboards. This edition is designed for organizations that require **advanced reporting, faster support, and expert assistance for setup and optimization**. ## Worklog Reports \& Timesheet Gadget The [Worklog Reports \& Timesheets Gadget](https://documentation.stonikbyte.com/great-gadgets/worklog-reports-timesheets-gadget.md) enables teams to create flexible time reports based on Jira worklogs. It allows you to analyze time spent across projects, teams, and issues using powerful pivot tables and visual charts. ### Key Features * Build **custom timesheets** directly from Jira worklogs * Create **pivot tables** to summarize time data across multiple dimensions * Group and analyze worklogs by: * Author * Date * Project * Issue * Sprint or other Jira fields * Generate **weekly or monthly summaries** * Visualize results with **interactive charts** * Export or share reports directly on Jira dashboards ### Benefits * Gain clear visibility into **how time is spent across teams and projects** * Quickly generate **team or individual timesheets** * Support **resource planning and workload analysis** * Improve **reporting for stakeholders and management** * Replace manual spreadsheet-based timesheet tracking ## Priority Support Advanced Edition customers receive **priority access to the Great Gadgets support team**, ensuring faster assistance when issues arise. ### What You Get * **Faster response times** for support requests * **Priority handling** in the support queue * **Live Zoom sessions** for troubleshooting when needed * **Dedicated phone line** for urgent cases If you have the **Advanced Edition** of [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview), you can find the **emergency support phone line** in **Jira Administration \> Marketplace Apps \> Great Gadgets**. If you have the **Advanced Edition** of [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview), you can find the **emergency support phone line** in **Confluence Administration \> Apps \> Great Gadgets**. ### Benefits * Minimize downtime and disruptions * Resolve issues faster with direct access to experts * Get real-time assistance for complex problems ## Dedicated Customer Success Manager Advanced Edition includes **live enablement sessions** with a dedicated Customer Success Manager to help your team configure and optimize Great Gadgets for your workflows. ### What's Included * Ongoing support from your **dedicated Customer Success Manager** * **Live Zoom demonstration** of the app's capabilities * Guidance on **best practices for dashboards and reports** * Help with **configuration and setup** * Advice on **optimizing gadgets for your use cases** If you have the **Advanced Edition** of [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview), you can find your **Customer Success Manager** in **Jira Administration \> Marketplace Apps \> Great Gadgets**. If you have the **Advanced Edition** of [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview), you can find your **Customer Success Manager** in **Confluence Administration \> Apps \> Great Gadgets**. Use the provided contact details to schedule a call when necessary. ### Benefits * Accelerate adoption across your teams * Ensure dashboards and reports are configured correctly * Unlock advanced features faster ## Migration Assistance If you are migrating from **Jira Server or Data Center to Jira Cloud**, Advanced Edition includes guided assistance to ensure a smooth transition. ### What's Included * Guidance during the **migration process** * Help with **configuration alignment between environments** * Assistance validating **dashboard and gadget configurations** * Support for **data validation after migration** ### Benefits * Reduce migration risks * Ensure dashboards and reports work correctly in Cloud * Save time during the transition process --- language: "en" --- # Advanced Issue Filter Formula Gadget [https://www.youtube.com/watch?v=ibNsVdQgdUk\&t=1s](https://www.youtube.com/watch?v=ibNsVdQgdUk&t=1s) ## Overview This gadget allows displaying the result of up to 9 calculations of math formulas applied against the numerical fields or the count of the work items from multiple Jira filters. Comparing with the work item Filter Formula Gadget, it allows displaying up to 9 calculations results (instead of one), combines data from up to 9 filters (instead of one) and can do more advanced calculations (not only SUM, COUNT, AVG, MIN or MAX). For example, you could use this gadget to calculate and display the percent of work done or the percent of budget spent. ![image-20250611-120239.png](https://documentation.stonikbyte.com/__attachments/a_21579c84732706a7ca4ab9b1ec3ebe1abd0b926bc6195e9ff5d660957c339388/image-20250611-120239.png?cb=0f8c34487cd565212e5b9e1f94363acd) How does it work? The gadget lets you define up to 9 variables ('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', and 'i') calculated as COUNT, SUM, MAX, MIN or AVERAGE for a numeric field of the work items from a specified Jira work item filter. Then, you can combine these variables into up to 9 math formulas and display their results. ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings, such as display mode and refresh interval. ### Data tab On this tab you can configure the required settings of the gadget. ![Advanced-Formula---configuration-data-tab.png](https://documentation.stonikbyte.com/__attachments/a_4110e34b0e832a520a0eced78b34810abb5720b943e6f272d90e6c5a7e36785d/Advanced-Formula---configuration-data-tab.png?cb=6c5319f59aa6c5b525450d2b0d4b6392) | **Setting** | **Description** | |---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Variables** | Select the variable(s) 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h' or 'i' that you need and specify how they are calculated. By default, there are only 2 variable displayed, but you can use the **Add** (+) button to add up to 9 variables. For each of them, choose the **Formula** (SUM, MIN, MAX, COUNT or AVG) that is applied against the selected **Field** of the work items returned by the selected **Filter** or**JQL**string. * On Jira Server and Data Center, the scripted fields added via the ScriptRunner app are also available for selection here, but only if they are configured as numerical fields in the Custom Fields area of Jira Administration. More exactly, their Search Template must be set to Number Search. * On Jira Service Management, select the Satisfaction field to calculate, for example, the average Customer Satisfaction (CSAT) based on the feedback provided by your customers after their ticket is closed. | | **Data To Display** | Decide what numbers to display in the gadget by entering **Math Formulas** that combine one or more of the selected variables. By default, there are only 2 formula fields displayed, but you can use the **Add** (+) button to add up to 9 formulas. For each formula, enter a **Label** and specify with how many **Decimals** the formula result shall be displayed. Optionally, for each value displayed, you can specify a **Prefix** and/or **Suffix** of up to 10 chars representing the unit of measure. The prefix, for instance '$', will be displayed before the calculated value (ex. '$8500.50'), while the suffix, for instance '%', will be displayed after the calculated value (ex. '55.69%'). If you check **Format with commas**, values like '$8500.50' will be displayed like '$8,500.50'. **Color Settings** You can customize the display color of the value by clicking the green square on the right side. By default, the value is shown in green, but you can choose any color to better suit your needs. ![image-20250611-121912.png](https://documentation.stonikbyte.com/__attachments/a_72b323959ea93cb8794f6b9036a65d5bc8f5c2f19405d53a747dc8eb9a7be89c/image-20250611-121912.png?cb=544708520c3d0e1015f13689ea735a92) Choose how the displayed results should be colored: * **Fixed color** - choose this option if you want to apply a fixed chosen color, regardless of the result value. ![image-20250930-114010.png](https://documentation.stonikbyte.com/__attachments/a_5a1d89381803f7aeb3542f2c156f946dd8167bd87a5a57e3c43c9ea40fa8246a/image-20250930-114010.png?cb=cffb4abd94d791b07a810223d53793f7) * **Number colored by value** - choose this option if you want to apply different colors to specified value ranges. In this case, you need to set custom limits and colors. ![image-20250930-113651.png](https://documentation.stonikbyte.com/__attachments/a_80b8ad2cdcf8f5dc42cf0037e49ff933f1b4af5d48bc13f3bcc41a32a98892be/image-20250930-113651.png?cb=a2f3eb879223da72b2d49559c7561695) If you check **Extra highlight by coloring border,**the gadget will color the border in the same color. ![image-20250930-114205.png](https://documentation.stonikbyte.com/__attachments/a_54aa67634f7ea2fc2bbcbce49c5a543b2c9396aee7227c8e529b435550142f3a/image-20250930-114205.png?cb=221e3a9b9d143cb13cfeaea37e10078b) | Example: Let's assume that you want to display the percent of work done (by story points) for a project. Here are the steps to perform: * You have to create two filters: * a filter that returns all the work items from the project. * a filter that returns only the work items from the project that are done. * Then, you have to define two variables: * 'a' that will be calculated as the SUM of Story Points field of the work items from the first filter. This represents the total estimated work, in story points. * 'b' that will be calculated as the SUM of Story Points field of the work items from the second filter. This represents the total amount of work done, in story points. * Finally, display the numbers by entering the following math formulas: * 'a' - to display the value of 'a' variable representing the total estimated work. * 'b' - to display the value of 'b' variable representing the total work done. * '(b / a) \* 100' - to calculate and display the percent of work done * Proceed in the same way to calculate and display other project key-numbers. The gadget displays 'NaN' (Not a Number) if the result of the formula cannot be calculated. This can happen in case of division by zero or when one of the variables cannot be calculated (for example, the AVG or MAX for a filter that returns no work items). In the **Math Formula** field, you can also use the following mathematical functions: ABS, MIN, MAX, and FLOOR. ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Advanced Formula - configuration more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_0e502f333c6cd585a827375835fea9ef789eb146f0147362eda65b229b530177/Advanced%20Formula%20-%20configuration%20more%20settings%20tab.png?cb=82988b0fbb9e71ae18e523f1c76100f6) | **Setting** | **Description** | |----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Display mode** | Choose how the formula results will be displayed. **As cards** - check this option to display the results in a card format. Best for dashboards where you want to highlight and draw attention to key metrics. ![image-20250529-083049.png](https://documentation.stonikbyte.com/__attachments/a_55f24bcdb0aa933ee07c89b2d6950d78e381a33376b98081f6f0cee4e82b597a/image-20250529-083049.png?cb=5bfe572210b23cbb4ac34175be5a4ece) **As inline text** - check this option to display the results as simple text, which fits better in compact layouts like tables in Confluence. ![image-20250523-063135.png](https://documentation.stonikbyte.com/__attachments/a_2e2fe176025782c2cb747dd6e2d67d07d7bcb16db53615d2d98dfb06e6251444/image-20250523-063135.png?cb=7534d0cf510158fa4444b462ff41b810) | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [How to measure customer satisfaction in Jira or Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/06/27/how-to-measure-customer-satisfaction-in-jira-or-confluence-with-great-gadgets-app/) * [SLA Breaches in Jira: What they are, why they happen and how to track and prevent them using Great Gadgets for Jira](https://blog.stonikbyte.com/2025/06/20/sla-breaches-in-jira-what-they-are-why-they-happen-and-how-to-track-and-prevent-them-using-great-gadgets-for-jira/) * [7 Essential Team Performance Metrics To Track In Jira By Using Great Gadgets App](https://blog.stonikbyte.com/2025/08/14/essential-team-performance-metrics-to-track-in-jira-by-using-great-gadgets-app/) --- language: "en" --- # Control Chart Gadget ## Overview Depending on how you configure it, this gadget can calculate key metrics like "Cycle Time" or "Lead Time" for the work items from a specified filter and for a certain time interval. It shows the work items with their cycle time in a scatter plot chart. Optionally, the average cycle time can be displayed as a separate line and a custom threshold line can be added for easily identifying the work items that had an abnormally long cycle time. In addition, you can choose to display the rolling average line to see the trend and the standard deviation to easily identify the outliers. You can use this gadget to see how quickly your team delivers and to identify the work items that took longer than expected. Hovering the mouse pointer over an item in the chart will display a tooltip with the work item details, like the work item key or cycle time. ![image-20250722-065222.png](https://documentation.stonikbyte.com/__attachments/a_525dd7fbd904cad6011aabf988d0d071acb1500be9304a81a2a477d46f4dfc77/image-20250722-065222.png?cb=aa5fd2fd11abba64c9a294ea4d0aeb24) The data is displayed for a specified time interval or an interval relative to the current day. The gadget identifies those work items from the specified filter (or dashboard's filter) that had a cycle completed in the specified time interval, determines the cycle(s) duration and displays them in the chart along with the date when their cycle was ended. See the settings description below for how to configure the gadget. **Tips \& Tricks** To calculate "Cycle Time", set the following: * Cycle starts = When the work item entered a status that has category "In Progress" * Cycle ends = When the work item entered a status that has category "Done" To calculate "Lead Time", set the following: * Cycle starts = When the work item was created OR When the work item entered a status that has category "New" * Cycle ends = When the work item entered a status that has category "Done". ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors**tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Control chart gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_c202a3933cb0cbd2c7b2bb5038067cf6e1276ce9f97a88ff3a727801120a6308/Control%20chart%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=7f706ec2deb64781ef63c5cbc36fb7fa) | **Setting** | **Description** | |---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data Source** used by the gadget: * Theagile**Board** of your team. * A **Saved filter** containing the work items for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check **Include the sub-tasks** if you want the sub-tasks from the selected board, filter or JQL to be included in the calculation. * A **JQL** query that returns the work items you want to be processed by the gadget. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_b8fd785e621cb7bd7a21418e3eaba9dedb19fba0790ce17aaafbff875208ce44/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Cycle starts** | Indicates what to consider as the start event of a cycle. You can choose between: * **When the work item was created** * **When the work item entered a status that has category "New"** - the cycle starts when the work item was transitioned to any workflow status of category "New". This includes those gray-colored statuses from Jira, like *New* , *Backlog* or *To Do*. * **When the work item entered a status that has category "In Progress"** - the cycle starts when the work item was transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like *In Work* , *In Progress* or *In Testing*. * **When the work item entered this status** - cycle starts when the work item was transitioned to the specified workflow status. Choose also how to handle the case when there are multiple transitions to the start status or to the status category by setting **If multiple entries in the start status, consider the ? entry** to *first* or *last*. See the example below. **Example** You configured the gadget to start the cycle **When the work item entered a status that has category "In Progress"** and to end the cycle **When the work item entered a status that has category "Done"** and there was a Jira work item that had multiple entries in the "In Progress" status before being moved to "Done". How should the cycle time be calculated, from the first or from the last transition in the "In Progress" status? ![image-20240618-081002.png](https://documentation.stonikbyte.com/__attachments/a_82327841f6546b791541d8a1b9c885bcd592dde5103078a793c48c5a3e400302/image-20240618-081002.png?cb=b0f126a479d8f1760c43de2d47f0d44e) If you set **If multiple entries in the start status, consider the** ***first*** **entry**, the cycle will start when the work item was transitioned in the "In Progress" status for the first time. ![image-20240618-081018.png](https://documentation.stonikbyte.com/__attachments/a_0890edced8f38c7de8d6e1ef7d66ca6cf62b5d5eb71aaaf115365d38b6cb3e01/image-20240618-081018.png?cb=53e04adbc5b13f042a2e4b293d0a7dcc) If you set **If multiple entries in the start status, consider the** ***last*** **entry**, the cycle will start when the work item was transitioned in the "In Progress" status for the last time. ![image-20240618-081032.png](https://documentation.stonikbyte.com/__attachments/a_14490fae99c5dbdeeb433fefd48bdf4f1c8833b6ebc1e9ef9bdbf5240e8a5c91/image-20240618-081032.png?cb=7ff46a676677a99504dab4da71e827a5) | | **Cycle ends** | Indicates what to consider as the end event of a cycle. You can choose between: * **When the work item entered a status that has category "Done"** - the cycle ends when the work item was transitioned to any workflow status of category "Done". This includes those green-colored statuses from Jira, like *Done* , *Resolved* or *Closed*. * **When the work item entered a status that has category "In Progress"** - the cycle ends when the work item was transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like *In Work* , *In Progress* or *In Testing*. * **When the work item entered this status** - the cycle ends when the work item was transitioned to the specified workflow status. * **When the work item entered its current status** You can also choose how to handle the case when there are multiple transitions to the end status by setting **If multiple entries in the end status, consider the ? entry** to *first* or *last*. See the example below. **Example** You configured the gadget to start the cycle **When the work item entered a status that has category "New"** and to end the cycle **When the work item entered a status that has category "Done"** and there was a Jira work item that had multiple entries in "Done". How should the cycle time be calculated, till the first or till the last transition in the "Done" status? ![image-20240618-081112.png](https://documentation.stonikbyte.com/__attachments/a_5ec1a3df6b557ee5d7e6c298a93510dcd6778bd5cfd2c234b4ab7fb0f041a258/image-20240618-081112.png?cb=092855c79ce8814068530d9040b64d54) If you set **If multiple entries in the end status, consider the** ***first*** **entry**, the cycle will end when the work item was transitioned to the "Done" status for the first time. ![image-20240618-081126.png](https://documentation.stonikbyte.com/__attachments/a_1f031828789d8ab96fb6f790666c90779d8e7d7524e1eebfde2d669a9702d5b9/image-20240618-081126.png?cb=78f136920c9f6127e0b54af08476eef9) If you set **If multiple entries in the end status, consider the** ***last*** **entry**, the cycle will end when the work item was transitioned to the "Done" status for the last time. ![image-20240618-081136.png](https://documentation.stonikbyte.com/__attachments/a_5a2d183bc82e287bb03b80f294513d0f013ab26421e4cb428c0e628257a4f6ed/image-20240618-081136.png?cb=8ae0d89e8f4a9bafe6c82847af47c94d) | | **Multiple cycles** | Decide how the gadget should handle those Jira work items that have multiple cycles. This situation occurs if the work item was transitioned multiple times through the start and the finish statuses of the cycle. **Example** You configured the gadget to start the cycle **When the work item entered a status that has category "In Progress"** and to end the cycle **When the work item entered a status that has category "Done"** and there was a Jira work item that was moved from "In Progress" to "Done" multiple times, so it had multiple cycles. What cycle do you want to be displayed? ![image-20240618-081147.png](https://documentation.stonikbyte.com/__attachments/a_0c459945378462119cc7e0c54cfc34c8f8ae6e00dc0833b53e45bf6ef8d19171/image-20240618-081147.png?cb=9ac434fe0cd51313821569310ae13056) You can choose between: * *Display all cycles* - all the cycles that have ended within the time range displayed by the chart will be displayed having their own dot in the plotting chart and their own entry in the data table. * *Display only the first cycle* - only the first cycle of the work items that has ended within the time range displayed by the chart will be displayed, with all the others being ignored * *Display only the last cycle* - only the last cycle of the work items that has ended within the time range displayed by the chart will be displayed, with all the others being ignored * *Display as one cycle from the start time of the first cycle to the finish time of the last cycle* - a single cycle will be displayed, having as the start time the moment when the first cycle started and as the finish time the moment when the last cycle ended. See the picture below. ![image-20240618-081158.png](https://documentation.stonikbyte.com/__attachments/a_89713dea20f31a977f8c956692f39538295f7380c1abc27370ed28b41d04cad3/image-20240618-081158.png?cb=42da8a1ab8aa4abdda6d9bd5c5c6bea2) * *Display as sum of all cycles* - a single cycle will be displayed, with the start time being the moment the first cycle started and the end time being the moment the last cycle ended, and its duration calculated as the sum of all cycles. | | **Time interval** | Represents the time interval displayed by the gadget. You can choose from multiple options: **Custom dates** - choose this option if you want to manually enter a *Start date* and an *End date*. **A number of days back** - By choosing this option, the gadget will use a rolling time interval with a number of days back to the current day. **Dates of a project release** - Choose this option if you want the gadget to use the start and end dates of an existing project release (added on the Releases page of a Jira space). Make sure the selected release has a *Start date* and *End date* set. Any subsequent changes to the release dates made on the space's Releases page will be automatically reflected in the gadget, without the need to reconfigure it. **Dates of a sprint** - Choose this option if you want the gadget to use the start and end dates of an existing sprint. Only the dates are considered (not also the hours). The start of the interval will be the start date of the sprint with time at the start of day, while the end of the interval will be the end date of the sprint with the time at the end of day. When enabled, you'll need to select the board the sprint belongs to. If you choose the *Latest sprint (auto)* , the date range will automatically match the most recent sprint. If you choose the *Previous sprint (auto)*, the date range will automatically match the sprint immediately before the latest one. If you manually select a specific sprint, any changes made to its dates on the board will be automatically reflected in the gadget, without the need to reconfigure it. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Control chart gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_379fa76e7606e3f65ad5258c024584b8e1b08a037486424ffc2eba392423932e/Control%20chart%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=1a3d8e615edfd7d380b45ecf74104408) | **Setting** | **Description** | |---------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Calculate in** | Specify in what time unit measure the results will be displayed. | | **Don't count weekends** | Check this option if you want to exclude the weekends (Saturdays and Sundays) from the cycle time calculation. | | **Display average line** | Check this option if you want the chart to display a line with the average cycle time for the specified time interval. | | **Exclude breaches from average calculation** | Check this option if you want the average calculation to exclude work items that exceeded the set threshold (breaches). This option has no effect if no threshold is set. | | **Display rolling average line and standard deviation** | Check this option if you want the chart to display the rolling average line, which allows visualizing the trend, along with the standard deviation that allows identifying the outliers. You must also specify the odd number of X work items representing the window used for calculating the rolling average and the standard deviation. The rolling average and standard deviation are work item-based, not time-based. For every work item shown on the chart, the rolling average and the standard deviation (at that point in time) are calculated by taking the item itself, X/2 items before the work item and X/2 items after the work item, then averaging their cycle times. For example, if you choose to calculate based on a 15-items window, the calculation will be based on the item itself, with 7 items to the left and 7 items to the right. | | **Display threshold line** | Check this option if you want the chart to display a line representing a threshold. The items that have a cycle time higher than the specified **Threshold** value will be colored in red. | | **Display percentile lines** | Check this option and enter the values (percents) corresponding to the percentiles to be displayed. A percentile is a value from the data set that splits the data into two pieces: the lower piece contains the percent of the data, and the upper piece contains the rest of the data. For example, the 75% percentile will be displayed as a horizontal line with 75% of the items under it and the rest of the items (25%) over it. | | **Use logarithmic scale for the vertical axis** | Check this option if you want the chart to display a logarithmic scale instead of a linear scale for the Y axis. | | **Show legend** | Check this option if you want the chart legend to be displayed. | | **Show data table** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays the items along with their cycle time details and the average calculation. ![Control-chart-gadget---data-table.png](https://documentation.stonikbyte.com/__attachments/a_e7a1610f512945439b69036eb06ef7b007a0ff29fb7d887f66e280b7432c83d6/Control-chart-gadget---data-table.png?cb=94b666d5cc6f2bb60b9220216a5ebd54) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Control chart gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_d94887b2a87f17bb30b1ccf65f73756e7c69584bb0ef7231edefe153638e7abc/Control%20chart%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=92347839f693b1d858087b9fe60a2acd) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [How to measure Cycle Time and Lead Time in Jira or Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/10/02/how-to-measure-cycle-time-and-lead-time-in-jira-or-confluence-with-great-gadgets-app/) * [SLA Breaches in Jira: What they are, why they happen and how to track and prevent them using Great Gadgets for Jira](https://blog.stonikbyte.com/2025/06/20/sla-breaches-in-jira-what-they-are-why-they-happen-and-how-to-track-and-prevent-them-using-great-gadgets-for-jira/) --- language: "en" --- # Countdown Gadget ## Overview This gadget shows the remaining time until an upcoming event. Use this gadget to make your team aware of the remaining time until the next project launch or milestone, the Christmas Party or any other important event for your team or company. ![image-20250703-120731.png](https://documentation.stonikbyte.com/__attachments/a_c3ea472fb7fb13eacefed71ee2ca34746870a6700891ebdbec3fd1ee9b0cb6fb/image-20250703-120731.png?cb=d4bf658b59316328b8dae116c8893c8a) ## Configuration On this tab you can configure the required settings of the gadget. ![image-20240130-071233.png](https://documentation.stonikbyte.com/__attachments/a_91d450c1849f5ad2bb0d183ac8f2b31580de159e8d638b6a9260306547abe8f7/image-20240130-071233.png?cb=91d582650f76b7f2dd39a699f42a1966) | **Setting** | **Description** | |--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Gadget Title** | Choose what to display in the title bar of the gadget. | | **Date** | Specify the date and time for the upcoming event. | | **Top line** | The text to be displayed on the line above the remaining time. | | **Bottom line** | The text to be displayed on the line below the remaining time. | | **Don't count weekends** | Check this option if you want the gadget not to count the weekends (Saturdays and Sundays). This option could be used to determine how many effective workdays remain until a specific milestone. | | **Time format** | Choose how the remaining time to be displayed by the gadget. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) --- language: "en" --- # Cumulative Flow Diagram (CFD) Gadget ## Overview This gadget displays the cumulative flow diagram (CFD) for the work items in an agile board or filter. It is a stacked area chart that shows the number of tasks in each column of the board or in each status category over time. When you view the data for a particular day, you will know how many work items were present in each column at the end of that day. You can choose to display the chart by Work Item Count, Story Points, Original Time Estimate, or any other numerical custom field. The cumulative flow diagram is one of the most advanced analytics in Agile project management. Use this gadget to determine how stable your flow is and to understand where you need to focus on making your process more predictable. It gives you quantitative and qualitative insight into past and existing problems. ![Cumulative Flow Diagram Chart Gadget.png](https://documentation.stonikbyte.com/__attachments/a_1894269448dff731e1c3a2a1f69ed452ccf7958339f10ce76845352d0e4554f6/Cumulative%20Flow%20Diagram%20Chart%20Gadget.png?cb=a4e72187f129e092ebea4fbb0f545f12) The gadget can be configured to display the chart as percentage of total: ![Cumulative Flow Diagram Chart Gadget - percent of total.png](https://documentation.stonikbyte.com/__attachments/a_4b602fce84102b373bfbb39f17f0926a0514a46b56167f112821263d57347823/Cumulative%20Flow%20Diagram%20Chart%20Gadget%20-%20percent%20of%20total.png?cb=4bc650df4c115dda46147e11efd26d60) Depending on how it was configured, the chart displays multiple series (or "bands"): **Done** - The total number of done work items. Depending on the gadget settings, "done" means all the work items with status category "done" (the green-colored statuses from Jira) or the items in the last column of the selected board. **In Progress** - The total number of "In progress" work items. Depending on the gadget settings, "in progress" means all the work items with the status category "in progress" (the blue-colored statuses from Jira) or the work items in the middle column(s) of the selected board. **To Do** - The total number of work items in "to do". Depending on the gadget settings, "To Do" means all the work items with the status category "To Do" (the gray-colored statuses from Jira) or the work items in the first column of the selected board. Also, if so configured, the gadget can display bands that correspond to the columns of a selected agile board. In this case, the series names will be the same as the column names. ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![CFD gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_6381625ab3b21a7bb02c0a8d16cee2d5a12baebe1db2dd377f7a357b1f8b7184/CFD%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=f9f00a03950ab90ad574126a17de203f) | **Setting** | **Description** | |------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data source** used by the gadget: * Theagile**Board** of your team. * A **Saved filter** containing the work items that you want to track. Make sure that the specified filter is shared with the users who will also visualize this gadget. * A **JQL** query that returns the work items you want to be processed by the gadget. * A **Sprint** selected from a board. The gadget will include only the work items that belong to the selected sprint of the specified board. You can select: * **Latest sprint (auto)** - select this option if you wantthe most recent sprint that is either closed or active to be used by the gadget. * **Previous sprint (auto) -**select this option if you want the gadget to display the penultimate sprint. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** - Select one or more work items above the Epic level, such as Initiatives or Themes. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_71bb8b4f66ae145294623ad2bd65db2ac77319843b062db30441948bf4c06514/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Calculate by** | Specify on which criteria the calculation is to be performed. You can choose between: * **Work Item Count** - the default value; use this if you want the chart to be made by the number of work items. * **Story Points** - use this if you want the chart to be made by summing up the Story Points of the work items in each band. If the work items are from team-managed spaces, select **Story Point Estimate** instead. * **Original Time Estimate** - use this if you want the chart to be made by summing up the Original Time Estimate of the work items in each band; the values will be displayed in hours. * Other **numerical custom field** defined in your Jira instance. | | **Include the sub-tasks** | Check this option if you want the sub-tasks from the selected board or filter to be included in the calculation. | | **Time interval** | Represents the time interval displayed by the gadget. You can choose from multiple options: **Custom dates** - choose this option if you want to manually enter a *Start date* and an *End date*. **A number of days back** - By choosing this option, the gadget will use a rolling time interval with a number of days back to the current day. **Dates of a project release** - Choose this option if you want the gadget to use the start and end dates of an existing space release (added on the Releases page of a Jira space). Make sure the selected release has a *Start date* and *End date* set. Any subsequent changes to the release dates made on the space's Releases page will be automatically reflected in the gadget, without the need to reconfigure it. **Dates of a sprint** - Choose this option if you want the gadget to use the start and end dates of an existing sprint. Only the dates are considered (not also the hours). The start of the interval will be the start date of the sprint with time at the start of day, while the end of the interval will be the end date of the sprint with the time at the end of day. When enabled, you'll need to select the board the sprint belongs to. If you choose the *Latest sprint (auto)* , the date range will automatically match the most recent sprint. If you choose the *Previous sprint (auto)*, the date range will automatically match the sprint immediately before the latest one. If you manually select a specific sprint, any changes made to its dates on the board will be automatically reflected in the gadget, without the need to reconfigure it. You can also check the **Continue to display data after end date** option in the **More Settings** tab if you want the chart to still display data even if the end date has passed. | | **Intervals of** | Indicates the length of the intervals displayed on the horizontal axis. | | **Chart bands are based on** | Specify by which criteria the bands displayed in the chart are determined. You can choose between: **The work item status categories** - the default value. When using this option, the chart displays 3 bands: * *Done* - counts all the work items with the status category "done" (the green-colored statuses from Jira) * *In progress* - counts all the work items with the status category "in progress" (the blue-colored statuses from Jira) * *New* - counts all the work items with the status category "new" (the gray-colored statuses from Jira) **The work item statuses** - when using this option, each workflow status that is mapped on the columns of the selected board has a corresponding band in the chart. If a filter is selected, the chart displays a band for each of the workflow statuses reached by the work items from the filter. **The columns of the selected board** - when using this option, each column of the board has a corresponding band in the chart, displaying the number of work items in that column. **The category of the columns in the selected board** - When using this option, the chart displays 3 bands: * *Done* - counts all the work items in the last column of the selected board. * *In progress* - counts all the work items in the middle column(s) of the selected board. * *New* - counts all the work items in the first column of the selected board. **The work item types** - when using this option, each work item type has a corresponding band in the chart, displaying the number of work items with that type. **The values of this field** - when using this option, each value of the specified has a corresponding band in the chart, displaying the number of work items having that value. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![CFD gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_47aa0b3d81416c58ea82481189ac2eba1d2c1d16ecbbc555e67a1298b41c9e1d/CFD%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=e79e607f830ffeaedd4f22948bfc62e1) | **Setting** | **Description** | |---------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Show legend** | Check this if you want the chart legend to be displayed. | | **Show as percentage of total** | Check this option if you want the chart to display percentages of total instead of the calculated values. | | **Continue to display data after end date** | Check this option if you want the chart to still display data even if the end date passed. | | **The vertical axis always starts at 0** | Check this option if you want the vertical axis to always start at 0. | | **Exclude these bands** | Check this option if you want to chart to exclude certain bands. Type the band names separated with a comma. | | **Display bands in this custom order** | Check this option if you want the chart to display bands in a custom order. Type the band names separated with a comma. Bands that are not specified will be still be shown after the ones you added. | | **Hide weekends** | Check this option if you want the chart not to show weekend days (Saturday and Sunday). | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Show the entire time interval** | Check this option if you want the chart to display the entire time interval. | | **Enable scroll zoom** | Check this if you want to be able to zoom-in while scrolling with the mouse wheel over the chart. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![CFD gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_5ad7a402cf65ca89f09e7b34f871eb9bb2ed767e3360130db698ce3163fa72e2/CFD%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=f225cd8786a96b2c87eb73d40efa6f72) | **Setting** | **Description** | |---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. By default, only the common series are listed, but you can use the **Add** (+) button to add additional series to the table. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://wordpress.com/post/blog.stonikbyte.com/104) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [Tracking Customer Sentiment in JSM with Great Gadgets for Jira](https://blog.stonikbyte.com/2025/02/14/tracking-customer-sentiment-in-jsm-with-great-gadgets-for-jira/) * [7 Essential Team Performance Metrics To Track In Jira By Using Great Gadgets App](https://blog.stonikbyte.com/2025/08/14/essential-team-performance-metrics-to-track-in-jira-by-using-great-gadgets-app/) --- language: "en" --- # Cycle Time Trend Gadget ## Overview Depending on how you configure it, this gadget can calculate the key Kanban metrics like "Cycle Time" or "Lead Time" and display their trend. Or, you can simply calculate the time between two Jira statuses from the workflow. Use this gadget to see how fast your team delivers and to identify bottlenecks in your process flow. * "Cycle Time" is the amount of time that the team spent working on an item without the time that the task spent waiting on the board. Therefore, the Cycle Time should start being measured when the item task enters a "working" status, not earlier. * "Lead Time" is the time from the moment when the request was made by a client and placed on a board to when all the work on it is completed and the request is delivered to the client. So it is the total time the client is waiting for an item to be delivered. ![Cycle time trend chart gadget.png](https://documentation.stonikbyte.com/__attachments/a_a12e1ba2b27023dc5906886ef4c54f73ad102ef88b726e8be85e5a751dc5f3e0/Cycle%20time%20trend%20chart%20gadget.png?cb=2b7bb05fb35c20aa282af5172f5ffaf2) The data is displayed for a specified number of time intervals relative to a specified date. For each time interval, the gadget identifies those work itemss from the specified filter (or dashboard's filter) that had a cycle completed in that interval, determines the cycle(s) duration, calculates the average time for that interval and displays it in the trend chart. See the settings description below for how to configure the gadget. **Tips \& Tricks** To calculate "Cycle Time", set the following: * Cycle starts = When the work items entered a status that has category "In Progress" * Cycle ends = When the work items entered a status that has category "Done" To calculate "Lead Time", set the following: * Cycle starts = When the work items was created or when the work items entered a status that has category "New" * Cycle ends = When the work items entered a status that has category "Done" ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Cycle time trend gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_aff7cf6850d49c51c77608f612c97cb9fe792c2775564d017d1e368986ca5548/Cycle%20time%20trend%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=7dd38b66b8554d10112dcd2764f62c53) | **Setting** | **Description** | |-----------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data Source** | Select the type of **Data Source** used by the gadget: * Theagile**Board** of your team. * A **Saved filter** containing the work items for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check **Include the sub-tasks** if you want the sub-tasks from the selected board, filter or JQL to be included in the calculation. * A **JQL** query that returns the work items you want to be processed by the gadget. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_7c88b7a4863588df45750dc8e2e7885f3dcdfcb8ff09fe51a3122d437feed909/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Cycle starts** | Indicates what to consider as the start event of a cycle. You can choose between: * **When the work items was created** * **When the work items entered a status that has category "New"** - the cycle starts when the work items was transitioned to any workflow status of category "New". This includes those gray-colored statuses from Jira, like *New* , *Backlog* or *To Do*. * **When the work items entered a status that has category "In Progress"** - the cycle starts when the work items was transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like *In Work* , *In Progress* or *In Testing*. * **When the work items entered this status** - cycle started when the work items was transitioned to the specified workflow status. Choose also how to handle the case when there are multiple transitions to the start status or to the status category by setting **If multiple entries in the start status, consider the ? entry** to *first* or *last*. See the example below. **Example** You configured the gadget to start the cycle **When the work items entered a status that has category "In Progress"** and to end the cycle **When the work items entered a status that has category "Done"** and there was a Jira work items that had multiple entries in the "In Progress" status before being moved to "Done". How should the cycle time be calculated, from the first or from the last transition in the "In Progress" status? ![image-20240618-080604.png](https://documentation.stonikbyte.com/__attachments/a_3df980e07eafac376decb580d87fe3ef7eb51065487f6a540a18b5916352ff9a/image-20240618-080604.png?cb=b0f126a479d8f1760c43de2d47f0d44e) If you set **If multiple entries in the start status, consider the** ***first*** **entry**, the cycle will start when the work items was transitioned in the "In Progress" status for the first time. ![image-20240618-080633.png](https://documentation.stonikbyte.com/__attachments/a_8dc3dcdc4fe8d540ad28a9f3cfa46c2dbdea28861f48221e9056dfc1f3a4985f/image-20240618-080633.png?cb=53e04adbc5b13f042a2e4b293d0a7dcc) If you set **If multiple entries in the start status, consider the** ***last*** **entry**, the cycle will start when the work items was transitioned in the "In Progress" status for the last time. ![image-20240618-080644.png](https://documentation.stonikbyte.com/__attachments/a_06152e03a42109db7ecd797c6feabd48f68391202ccc8e484542baef7b9936ce/image-20240618-080644.png?cb=7ff46a676677a99504dab4da71e827a5) | | **Cycle ends** | Indicates what to consider as the end event of a cycle. You can choose between: * **When the work items entered a status that has category "Done"** - the cycle ends when the work items was transitioned to any workflow status of category "Done". This includes those green-colored statuses from Jira, like *Done* , *Resolved* or *Closed*. * **When the work items entered a status that has category "In Progress"** - the cycle ends when the work items was transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like *In Work* , *In Progress* or *In Testing*. * **When the work items entered this status** - the cycle ends when the work items was transitioned to the specified workflow status. You can also choose how to handle the case when there are multiple transitions to the end status by setting **If multiple entries in the end status, consider the ? entry** to *first* or *last*. See the example below. **Example** You configured the gadget to start the cycle **When the work items entered a status that has category "New"** and to end the cycle **When the work items entered a status that has category "Done"** and there was a Jira work items that had multiple entries in the "Done". How should the cycle time be calculated, till the first or till the last transition in the "Done" status? ![image-20240618-080718.png](https://documentation.stonikbyte.com/__attachments/a_29b9f097d040e8d0b14d127b230f28604af27552e8c585b9aabab14c1eb909cf/image-20240618-080718.png?cb=092855c79ce8814068530d9040b64d54) If you set **If multiple entries in the end status, consider the** ***first*** **entry**, the cycle will end when the work items was transitioned in the "Done" status for the first time. ![image-20240618-080729.png](https://documentation.stonikbyte.com/__attachments/a_ea54557a32fd161a341951314a38f24ef13e2b4b13cab98bfdacf3ba0144e51a/image-20240618-080729.png?cb=78f136920c9f6127e0b54af08476eef9) If you set **If multiple entries in the end status, consider the** ***last*** **entry**, the cycle will end when the work items was transitioned in the "Done" status for the last time. ![image-20240618-080739.png](https://documentation.stonikbyte.com/__attachments/a_e5c48acc9d5bb8521dc91806bfe860640fd23cccbbe095bf99d66123f7727bec/image-20240618-080739.png?cb=8ae0d89e8f4a9bafe6c82847af47c94d) | | **Multiple cycles** | Decide how the gadget should handle those Jira work itemss that have multiple cycles. This situation occurs if the work items was transitioned multiple times through the start and finish statuses of the cycle. **Example** You configured the gadget to start the cycle **When the work items entered a status that has category "In Progress"** and to end the cycle **When the work items entered a status that has category "Done"** and there was a Jira work items that was moved from "In Progress" to "Done" multiple times, so it had multiple cycles. What cycle do you want to be displayed? ![image-20240618-080753.png](https://documentation.stonikbyte.com/__attachments/a_b7b0a8e26ccbb6cba52a401d6a338f951863b844a6dc8ac7652f363c810e8329/image-20240618-080753.png?cb=9ac434fe0cd51313821569310ae13056) You can choose between: * *Display all cycles* - all the cycles will be displayed with their own dot in the plotting chart and their own entry in the data table. * *Display only the first cycle* - only the first cycle of the work items will be displayed, with all the others being ignored * *Display only the last cycle* - only the last cycle of the work items will be displayed, with all the others being ignored * *Display as one cycle from the start time of the first cycle to the finish time of the last cycle* - a single cycle will be displayed, having as the start time the moment when the first cycle started and as the finish time the moment when the last cycle ended. See the picture below. ![image-20240618-080805.png](https://documentation.stonikbyte.com/__attachments/a_4342a400b38006078fdbcde32e72e6201e22a62d630f8b3682cd053ea4d8b4ee/image-20240618-080805.png?cb=42da8a1ab8aa4abdda6d9bd5c5c6bea2) * *Display as sum of all cycles* - a single cycle will be displayed, with the start time being the moment the first cycle started and the end time being the moment the last cycle ended, and its duration calculated as the sum of all cycles. | | **Display data until:** | Specify the date until the data is displayed. You can choose between: **This date (recommended)** : - The time intervals will be aligned with the specified date. **Previous day (end-of-day)** - the data will be displayed until the end of Yesterday without the need to manually enter a date. | | **Interval duration** | Specify the duration (in weeks, calendar month or board sprints) for the time intervals used when calculating and displaying the average time. | | **Display the data for the last ? intervals** | Specify the number of time intervals to be displayed in the chart relative to the date specified at "Display data until". | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Cycle time trend gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_cd2447dd7e42952dc532c5b74bb14e3e39061646620a638e11036236685d6d48/Cycle%20time%20trend%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=733aa0aedae5c6abe032e45a4c417199) | **Setting** | **Description** | |--------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Calculate in** | Specify in what time unit measure the results will be displayed. | | **Series to Display** | Choose what series to display in the chart. You can select one or more options: **Average Cycle Time** - displays the average cycle time for each time interval in the chart. **Trendline** - displays a line on the chart that reveals the overall direction of the data. The trendline can be: * *Linear* - a best-fit straight line that shows if the average cycle time is increasing or decreasing at a steady rate. * *Polynomial* - is a curved line determined based on an order 2 polynomial formula, which is recommended when the data fluctuates. | | **Don't count weekends** | Check this option if you want to exclude the weekends (Saturdays and Sundays) from the cycle time calculation. | | **Show the Overall Average Cycle Time, calculated as the average of the last ? intervals** | Check this option and specify a number of intervals, if you want the chart to calculate and display the overall average. | | **Show legend** | Check this option if you want the chart legend to be displayed. | | **Show data tab** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays, for every time interval in the chart, the work items along with their cycle time details and the average calculation. ![Cycle-time-trend-gadget---data-table.png](https://documentation.stonikbyte.com/__attachments/a_38b9f7a12fbb1049ca5f17c4be5709796e9d49000563513af2eab8fe5626db42/Cycle-time-trend-gadget---data-table.png?cb=8fc8d305ffe4b6982904afc4cfb446b9) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Tilted labels for x-axis** | Check this option to avoid overlapping labels on the x-axis. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Cycle time trend gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_4df6c1fe279eb08695c713773667c9b3b080c6a366eebf25b4fca798e2dede9b/Cycle%20time%20trend%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=4a0d37f6b969ce81205801cd834fcff4) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [How to measure Cycle Time and Lead Time in Jira or Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/10/02/how-to-measure-cycle-time-and-lead-time-in-jira-or-confluence-with-great-gadgets-app/) --- language: "en" --- # Data Residency ## What is Data Residency? **Data residency** is a feature that allows you to select and pin the geographical location (e.g., USA, EU, India, Australia) where your app data is stored. This ensures compliance with data privacy regulations by keeping your data within specific regions. This feature is available with both **Standard** and **Advanced** editions. ## Enabling Data Residency in Great Gadgets for Jira Cloud Data residency is disabled by default, which means app data is stored in a global table replicated across USA and EU geographical regions. This replication ensures better availability and optimizes app performance. Follow these steps to enable **Data Residency** for **Great Gadgets for Jira Cloud** and select the region where your app data will be stored: * Log in to **Jira Cloud** as an**administrator**. * Navigate to **Settings \> Marketplace apps**. * Click **Great Gadgets** in the left-hand navigation pane. * **Enable** **Data Residency** and select one of the available geographical locations to store your app data. ![image-20260227-094840.png](https://documentation.stonikbyte.com/__attachments/a_8d5664c598bf8efb4003f2bae53d57f9f923d5e951223cd80ec06d24a60e4b7b/image-20260227-094840.png?cb=d50aa2e610523e15b3aa6fc8dfea5be4) * Click **Save** to apply the changes Once you save the changes, new data will be stored in the selected location. Any data remaining in the previous location will be automatically deleted within 90 days. These options are not available for AGC Jira Cloud instances, as it uses separate storage located in the USA to store application data. ## Enabling Data Residency in Great Gadgets for Confluence Cloud Data residency is disabled by default, which means app data is stored in a global table replicated across USA and EU geographical regions. This replication ensures better availability and optimizes app performance. Follow these steps to enable **Data Residency** for **Great Gadgets for Confluence Cloud** and select the region where your app data will be stored: * Log in to **Confluence Cloud** as an **administrator**. * Navigate to **Confluence administration \> Apps**. * Click **Great Gadgets** in the left-hand navigation pane. * **Enable** **Data Residency** and select one of the available geographical locations to store your app data. ![image-20260411-064347.png](https://documentation.stonikbyte.com/__attachments/a_5928f570a8fd4499d9011f53d63e6aa0497b79707c9990d3ffdb869c0fc0e367/image-20260411-064347.png?cb=dfb580ac5564fb8b2c1340eb4cc11d99) * Click **Save** to apply the changes Once you save the changes, new data will be stored in the selected location. Any data remaining in the previous location will be automatically deleted within 90 days. These options are not available for AGC Confluence Cloud instances, as it uses separate storage located in the USA to store application data. ## Frequently asked questions ### What Data Does the Great Gadgets App Store? For details on the data stored by the Great Gadgets app, please refer to the [Privacy \& Security](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=privacy-and-security) tab on the app listing in the Atlassian Marketplace. ### Can I Disable Data Residency After Enabling It? Yes. You can disable **Data Residency** at any time. Once disabled, new data will be stored in the global location, and any data remaining in the previous region will be automatically deleted within 90 days. For any questions regarding Data Residency or the Great Gadgets app, please contact StonikByte Support by submitting a ticket [here](https://stonikbyte-production.atlassian.net/servicedesk/customer/portal/1) or by emailing [support@stonikbyte.com](mailto:support@stonikbyte.com). --- language: "en" --- # FAQ - Frequently Asked Questions ## General ### **What is Great Gadgets?** Great Gadgets is a powerful app for Jira and Confluence that helps teams track performance, progress, and predictability through insightful Jira dashboards and custom reports in form of Confluence pages. It offers a wide range of gadgets and macros that visualize key Agile metrics --- such as burndown charts, velocity, cycle time, control charts, cumulative flow diagrams, and more --- all within your Jira dashboards or Confluence pages. ### **Who is Great Gadgets for?** It's designed for **Scrum Masters, Agile Coaches, Product Owners, Project Managers, Team Leads**, and anyone who wants actionable insights from Jira data. ### **Is Great Gadgets a Forge-based app?** Yes. Great Gadgets is a Forge-based app built using Atlassian Forge Remote. This architecture combines Forge's security and compliance model with the flexibility of remote compute for advanced capabilities. ### **Why should I choose Great Gadgets over other Jira reporting apps?** Unlike many reporting tools, Great Gadgets is designed for *both simplicity and depth* . You can configure powerful visual reports in minutes --- no complex setup or external data processing needed. It supports **Scrum, Kanban, SAFe®, and hybrid methodologies** , provides **real-time Jira integration** , and ensures **data accuracy and reliability** directly from your Jira issues. Plus, its **flexibility** allows you to track multiple teams, projects, or boards in a unified view --- something that many competing apps can't do natively. With **Great Gadgets** , you don't need multiple separate apps for project and release tracking, time-in-status reporting, flow metrics, SLA tracking, custom charts, or BI-style analytics --- it gracefully covers **all these aspects** in one unified, easy-to-use solution. ### **Can Great Gadgets replace my Excel spreadsheets?** Yes, it eliminates the need to export and manually process Jira data in Excel or other external tools. With Great Gadgets, all your metrics, calculations, and visualizations are generated automatically and always stay up to date --- directly inside Jira or Confluence. Whether you need **project summaries** ,**pivot tables** ,**pivot charts** ,**custom formulas \& KPIs** ,or**performance analytics**, everything is computed, visualized, and refreshed in real time, without the hassle of spreadsheets or manual data manipulation. ### **Is there a free trial available?** Yes, Great Gadgets has a **30-day free trial** period available directly from the Atlassian Marketplace. ### **Where can I find help or tutorials?** You can find detailed tutorials, videos, and step-by-step guides on our [++blog page++](https://blog.stonikbyte.com/), [++YouTube channel++](https://www.youtube.com/@stonikbyte/videos) and [++documentation++](https://documentation.stonikbyte.com/great-gadgets.md). If you can't find the answer to your question or need more information about Great Gadgets, feel free to contact us directly at [++support@stonikbyte.com++](mailto:support@stonikbyte.com). ### **How can I contact support?** Our support team is available via our [++support portal++](https://stonikbyte-production.atlassian.net/servicedesk/customer/portal/1) or by emailing [++support@stonikbyte.com++](mailto:support@stonikbyte.com). ## **Features and Functionality** ### **Can I use Great Gadgets with Jira Cloud or Data Center?** Yes. Great Gadgets is available for **both Jira deployment types** --- Cloud and Data Center --- with the same consistent functionality across them. It's optimized for performance, even on large Jira instances. ### **How easy is it to set up and use?** Extremely easy. Once installed, Great Gadgets integrates seamlessly with your Jira dashboards. You can add and configure gadgets using JQL, saved Jira filters, or boards --- no scripting or complex configuration required. Most teams are up and running within minutes. ### **How often does Great Gadgets update its data?** Unlike other apps, Great Gadgets pulls all information directly from Jira in real time without requiring data synchronization. Data refreshes automatically based on Jira's dashboard settings, and you can refresh a gadget manually at any time. ### **Does Great Gadgets support Scrum projects?** Absolutely! The app includes gadgets like the **Sprint Burndown Burnup Chart** , **Team** **Velocity Chart** , **Release Burndown Burnup Chart** and more, helping Scrum Masters and teams track sprint performance with precision. See this article for more information on how to build a complete dashboard for your Scrum projects: ### **Does Great Gadgets offers gadgets useful for Kanban projects?** Yes! The app offers a variety of gadgets that can be used to track kanban projects such as **Control Chart** , **Cycle Time Trend Chart** , **Histogram Chart** , **Cumulative Flow Diagram** , **WIP Aging Chart** , **WIP Run, Time in Status, Pivot Table \& Pivot Chart** and more. See this article for more information on how to build a complete dashboard for your Kanban projects: ### **Does Great Gadgets support agile-at-scale or SAFe®?** Yes! Great Gadgets is a powerful tool for teams and organizations using agile-at-scale frameworks such as SAFe**®**. You can build powerful dashboards, to track progress across multiple teams or to track the entire project release, product increment (PI) or Agile Release Train (ART). See this article for more information on how to track Scaled Agile projects: ### **What performance metrics can I track with Great Gadgets?** With Great Gadgets you can track many performance gadgets needed in any type of project, from Scrum metrics to Kanban, SAFe**®** and ITSM. You can track **velocity, throughput, cycle time, lead time, WIP, release progress**, and more --- all using configurable gadgets that pull data directly from Jira issues. **Here is a list with essential project metrics that you can track with Great Gadgets:** * Sprint Burndown and Burnup * Release Burndown and Burnup * Release ETA - Forecast * Sprint Velocity * Team Velocity * Epic Progress * Time In Status * AHT, ART, TTR, MTTR, Cycle Time, Lead Time * SLA Breaches * Work In Progress * Throughput/Velocity * Workflow Stability * Customer Satisfaction Score (CSAT) * Customer Sentiment * Cross-Team \& Cross-Projects Burndown / Burnup * Global Release Charts * Flow Velocity / Throughput * Flow Load \& Flow Distribution * Custom Metrics \& Custom Charts * Pivot Tables \& Pivot Charts ### **Can I include subtasks in my burndown or velocity charts?** Yes! Unlike Jira's native charts, the **Sprint Burndown Burnup Chart** , **Release Burndown Burnup Chart** and **Team Velocity Chart** allow you to **include subtasks** to get a more accurate view of your team's true progress. ### **Can I track release progress?** Yes. The **Release Burndown Burnup Chart** lets you visualize the progress of the entire release. It can also generate and display a **forecast**, and estimate the final release date, based on the overall team velocity. ### **Can I track multiple projects or teams in a single chart?** Yes. With the **Release Burndown Burnup Chart** you can generate a cross-project or cross-team release burndown/burnup in a few steps. The **Kanban Velocity Chart** also lets you track the velocity across multiple teams. See this article for more information on how to track multiple project or teams with the Release Burndown Burnup chart: ### **What estimation methods Great Gadgets supports?** Most charts allow you to choose between multiple estimation methods such as **story points, issue count, time estimate** or any other numerical **custom field**. ### **Can I display data from past sprints?** Yes. Gadgets like the **Sprint Burndown Burnup** **Chart** and **Team** **Velocity Chart** can show any past sprints. ### **Can I visualize the WIP breaches in charts?** Yes. The **WIP Run Chart** gadget allows you to set a maximum and minimum WIP limit for your items. It then highlights in red all the items that are above or below the set limits, and displays at the top of the chart the number of the WIP Breaches. The **Team Wallboard** and **WIP Aging Chart** gadgets can also consider the WIP limits of the agile boards and highlight the WIP breaches. ### **Can I measure cycle time or lead time?** Yes. The **Cycle Time Trend Chart** , **Control Chart** , or **Histogram Chart** gadgets are highly configurable and can be set to measure either cycle time or lead time or any other similar metrics like MTTR, ATR, AHT or TTR. See this article for more information on how to measure cycle time and lead time with Great Gadgets: ### **Can I track SLA Breaches?** Yes. With gadgets like **Control Chart** , **Histogram Chart** and **WIP Aging Chart** you can visualize the breaches by setting custom thresholds that will highlight the items that breached them. With the **Issue Filter Formula** , **Advanced Issue Filter Formula** and**Pivot Table \& Pivot Chart**you can visualize custom metrics about your SLA Breaches such as percent of total items or create multidimensional stats and charts and visualize breaches by assignee or projects. See this article for more information on how to track SLA Breaches: ### **Can I track the progress at the Epic level?** Yes! With Great Gadgets you can effectively track the progress at the Epic level, as well as the progress at Initiative, Theme or Feature level. Using gadgets like the **Release Burndown** **Burnup Chart** you can display epic burndown charts to track the progress of **epics** along the time. With the **Pivot Table \& Pivot Chart** gadget you can create real-time multidimensional stats and charts to monitor the progress of **epics** , **initiative** , **theme** or **feature** and analyze them by multiple dimensions such as assignee, status category, or project. See this articles for more information on how to track the progress at the Epic level with Great Gadgets: * * ### **Can I export data from the charts?** Yes, most gadgets have a **Data Table** that can be exported to a CSV format for reporting and sharing outside Jira. ### **Can I use a JQL query instead of a board or filter?** Yes. Almost all gadgets accept **custom JQL queries** for full flexibility in how data is retrieved. You can use Jira boards, saved filters and custom JQL queries as data sources for your gadgets. ### **Can I customize the chart colors?** Yes. The gadgets have a **Color tab** that lets you customize the colors as you like. ### **Can I display Great Gadgets charts in Confluence?** If you use Jira Cloud, must have [++**Great Gadgets for Confluence**++](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview) app installed to add gadgets into Confluence pages. If you use Jira Data Center, you can import the gadgets from Jira without the need of having Great Gadgets for Confluence installed. ### **Can I share dashboards that contain Great Gadgets charts?** Yes, as long as the person you are sharing the dashboard with has access to the projects and filters that contains the work items displayed by the gadgets. --- language: "en" --- # Feature parity between Server, Data Center and Cloud All gadgets and their functionalities available in Great Gadgets for Jira Server or Data Center are also available in the Cloud version. | **Feature** | **Server** | **Data Center** | **Cloud** | |-------------------------------------------------------|------------|-----------------|-----------| | Sprint Burdown Burnup Chart gadget | ✅ | ✅ | ✅ | | Release Burndown Burnup Chart gadget | ✅ | ✅ | ✅ | | Team Velocity gadget | ✅ | ✅ | ✅ | | Control Chart gadget | ✅ | ✅ | ✅ | | Cycle Time Trend gadget | ✅ | ✅ | ✅ | | Histogram Chart gadget | ✅ | ✅ | ✅ | | Time in Status gadget | ✅ | ✅ | ✅ | | Cumulative Flow Diagram (CFD) gadget | ✅ | ✅ | ✅ | | WIP Run Chart gadget | ✅ | ✅ | ✅ | | WIP Aging Chart gadget | ✅ | ✅ | ✅ | | Kanban Velocity / Throughput gadget | ✅ | ✅ | ✅ | | Pivot Table \& Pivot Chart gadget | ✅ | ✅ | ✅ | | Issue Formula gadget | ✅ | ✅ | ✅ | | Advanced Issue Filter Formula gadget | ✅ | ✅ | ✅ | | Work Breakdown Structure (WBS) gadget | ✅ | ✅ | ✅ | | Team Wallboard gadget | ✅ | ✅ | ✅ | | Countdown gadget | ✅ | ✅ | ✅ | | Regional Clock gadget | ✅ | ✅ | ✅ | | Great Gadgets Controller | N/A | N/A | ✅ | | Timesheets \& Worklog Reports gadget | N/A | N/A | ✅ \* | | Data Residency | N/A | N/A | ✅ | | Ability to import the gadgets as macros in Confluence | ✅ | ✅ | N/A\*\* | * Available with the Advanced Edition. \*\* Confluence Cloud does not support importing Marketplace app gadgets as macros. However, this functionality can be preserved by installing [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview). See [Using the gadgets in Confluence Cloud](https://documentation.stonikbyte.com/great-gadgets/how-to-use-great-gadgets.md#Using-the-gadgets-in-Confluence-Cloud). --- language: "en" --- # Gadgets offered The current version of Great Gadgets includes the following gadgets: | **Gadget** | **Category** | **Description** | |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![image-20261016-111501.png](https://documentation.stonikbyte.com/__attachments/a_20729db6822dd81e7abc4d72750d143694d9b83841a6b6397540f1fffb8473f1/image-20261016-111501.png?cb=dcee6343d67033fa4c15598bf30cfe7a) | agile Kanban scrum project management release management | **Team Wallboard Gadget** Displays the wallboard with the work items from a specified agile board. Use this gadget to see what your team is working on. For more details, see [Team Wallboard Gadget](https://documentation.stonikbyte.com/great-gadgets/team-wallboard-gadget.md). | | ![image-20260113-134219.png](https://documentation.stonikbyte.com/__attachments/a_2a05f9692317f011eab82ad6de6294b143cf9fa1afd94f64a900fa24b82331e8/image-20260113-134219.png?cb=9c5ac8bbe08cabd56327b6df86f3df53) | agile scrum project management release management | **Release Burnup Burndown Chart Gadget** Displays the Burnup or Burndown chart for a Jira issue filter representing your release scope. Use this gadget to track the progress of your project in an agile manner. For more details, see [Release Burndown Burnup Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/release-burndown-burnup-chart-gadget.md). | | ![image-20260113-134237.png](https://documentation.stonikbyte.com/__attachments/a_3db040c41f7ef2bb67d1efd99f4c97e24120e1c680302d8b898034f384fbdbc0/image-20260113-134237.png?cb=7ccc64f7477e77606e0bbbf79a0476c9) | agile scrum project management release management | **Sprint Burnup Burndown Chart Gadget** Displays the Burnup or Burndown Chart for a selected Agile sprint. Use this gadget to track the progress of your Agile team during the sprint. For more details, see [Sprint Burndown Burnup Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/sprint-burndown-burnup-chart-gadget.md) | | ![image-20260113-134253.png](https://documentation.stonikbyte.com/__attachments/a_4668447fc8c38ca866104533043b5e143158cdd45c783d2908b89288d3f86d6b/image-20260113-134253.png?cb=fe66f05a10bdca322cb911e2159565d9) | agile scrum project management release management | **Team Velocity Gadget** Calculates and displays the current average velocity of the Agile (Scrum) team along with the history of previous sprints. The team's velocity is an essential metric that helps the Agile teams not to over-commit during sprint planning meeting, but also helps them to see how they perform from a sprint to another. For more details, see [Team Velocity Gadget](https://documentation.stonikbyte.com/great-gadgets/team-velocity-gadget.md) | | ![image-20260113-134426.png](https://documentation.stonikbyte.com/__attachments/a_f90034ffebc1d9afd1d42a2339b12f0348abcdb668311174c067ecceb0f301d8/image-20260113-134426.png?cb=6f2ef4c21380e78874662a568434f159) | agile Kanban scrum project management release management | **Cumulative Flow Diagram** Displays the cumulative flow diagram (CFD) for the issues in an agile board or filter. It is a stacked area chart that shows the number of tasks in each column of the board or in each status category along the time. For more details, see [Cumulative Flow Diagram (CFD) Gadget](https://documentation.stonikbyte.com/great-gadgets/cumulative-flow-diagram-cfd-gadget.md) | | ![image-20260113-134446.png](https://documentation.stonikbyte.com/__attachments/a_85bd08792f0384fd7ba34eca04768cee0e93bddcf31758ecfaa61e693beb2663/image-20260113-134446.png?cb=57b3995a531917c8dec56a99793a893d) | agile Kanban project management release management | **Kanban Velocity Gadget** Calculates and displays the current average velocity / throughput of the Agile (Kanban) team based on the Jira issue filter or Agile board. Use this gadget to see how many story points your team burns along the time. For more details, see [Kanban Velocity Gadget](https://documentation.stonikbyte.com/great-gadgets/kanban-velocity-gadget.md) | | ![image-20260113-134604.png](https://documentation.stonikbyte.com/__attachments/a_4563483838ab2562e41d80e894730b203b42f2352bbd704027d8350581d2275a/image-20260113-134604.png?cb=907f8920a02845154b7f6614fc7ebd60) | agile Kanban project management release management | **Cycle Time Trend Gadget** Calculates the key Kanban metrics Cycle Time and Lead Time or simply the time between statuses and displays them as a trend chart. Use this gadget to see how fast your team delivers and to identify bottlenecks in your process flow. For more details, see [Cycle Time Trend Gadget](https://documentation.stonikbyte.com/great-gadgets/cycle-time-trend-gadget.md) | | ![image-20260113-134623.png](https://documentation.stonikbyte.com/__attachments/a_3c45b78b164b61cf6ed086174037c18da224ec74024b31f196090d526ababd17/image-20260113-134623.png?cb=a85d76dd5c8d56e6478c958e6b0a413f) | agile Kanban project management release management | **Control Chart Gadget** Control chart based on the cycle time of the issues from a filter. It shows the issues with their cycle time as well as the average line, trend (rolling average) line and standard deviation. A custom threshold line can be also added for easily identifying the issues that had a too long cycle time. Use this gadget to see how quickly your team delivers and to identify the issues that took longer than expected. For more details, see [Control Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/control-chart-gadget.md) | | ![image-20260113-134641.png](https://documentation.stonikbyte.com/__attachments/a_e75ecff9f4346031f45fc7d31a0d47fd0b0695e159a30bf8ef24dbdf40424758/image-20260113-134641.png?cb=6bc83dd6e51c38926a1a34961992e95a) | agile Kanban scrum project management release management | **WIP Aging Chart** Tracks the age (time in status or time in board column) of the 'in-progress' issues from an agile board or filter. Use this chart to easily determine the work items that take longer than expected and to see if the WIP limits are exceeded. For more details, see [WIP Aging Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/wip-aging-chart-gadget.md) | | ![image-20260113-134656.png](https://documentation.stonikbyte.com/__attachments/a_c4416508bb58a2b08bb9874397a36fb982ab86242134033fb16dc727189682c1/image-20260113-134656.png?cb=c763ff4b6f8344ec5424738c7e2cb6e7) | agile Kanban scrum project management release management | **WIP Run Chart** Shows how much work-in-progress (WIP) your team has over time and helps you find trends and patterns in the process. You can use this gadget to determine whether your team is accumulating more "work in progress" items over time or not, and whether the team has reached an optimal work pace without exceeding their own capacity. For more details, see [WIP Run Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/wip-run-chart-gadget.md) | | ![image-20260113-134707.png](https://documentation.stonikbyte.com/__attachments/a_da934d9a7a8531e5038b172c43b589c02da12485353bd94756b27cb89e888673/image-20260113-134707.png?cb=9bac495652ccbe7558352fee61ee3aab) | agile Kanban project management release management | **Histogram Chart Gadget** Histogram chart based on the cycle time of the issues from a filter. The chart plots the distribution of the issues cycle time as a series of bars. A custom threshold line can be also added for identifying how many issues had a longer cycle time than expected. Use this gadget to see how your team delivers, how many issues were resolved in the expected time frame and how many were not. For more details, see [Histogram Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/histogram-chart-gadget.md) | | ![image-20240726-062443.png](https://documentation.stonikbyte.com/__attachments/a_dc483ff383336e9975b512109ff2f845ec1b30a648413257701c581997c599bd/image-20240726-062443.png?cb=d46de56292f5e5e4ae6c0ccf5b468b84) | agile scrum Kanban project management release management | **Time in Status Gadget** Provides real-time insights into how long issues have been in the workflow statuses. This gadget is especially useful for identifying workflow bottlenecks, understanding team performance, and ensuring projects stay on schedule. For more details, see [Time in Status Gadget](https://documentation.stonikbyte.com/great-gadgets/time-in-status-gadget.md) | | ![image-20260113-134732.png](https://documentation.stonikbyte.com/__attachments/a_7362517d13936f94fa016ad469d228aaa09ff32ca7c2bcf7ec0777dc60c97936/image-20260113-134732.png?cb=4926c29f3c8628ea1bfdb41a4dcb2612) | agile scrum project management release management | **Work Breakdown Structure (WBS) Gadget** This gadget offers the Work Breakdown Structure (WBS) diagram in form of Initiatives \> Epic \> Parent Tasks \> Sub-Tasks for the issues from a Jira filter. With this gadget you have the high-level status of your epics or the entire project. For more details, see [Work Breakdown Structure (WBS) Gadget](https://documentation.stonikbyte.com/great-gadgets/work-breakdown-structure-wbs-gadget.md) | | ![image-20261013-082335.png](https://documentation.stonikbyte.com/__attachments/a_9b742b5f8a275aa655b876299f5303e78a9f99dcc6b7871e9d81d8d761e23c03/image-20261013-082335.png?cb=d4c58acbe7368da054389e663df0c0cc) | project management release management | **Pivot Table \& Pivot Chart Gadget** This gadget allows you to generate and display multi-dimensional pivot tables, heat-map tables orcustom pivot charts based on issues in your Jira instance using drag \& drop functionality, as you do it with tools like Excel, for example. For more details, see [Pivot Table \& Pivot Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/pivot-table-pivot-chart-gadget.md) | | ![Gadgets-offered---worklog.png](https://documentation.stonikbyte.com/__attachments/a_bf8a4e5c7156c89094ff022438a6faa21894df725373cf8819e5dc4fa94053ee/Gadgets-offered---worklog.png?cb=f31ea91fcbd5be7a0c34b0206725ad81) | project management release management TIME management | **Worklog Reports \& Timesheets Gadget** Available only in the Advanced Edition of Great Gadgets. This gadget helps teams analyze and report on time logged in Jira. It provides flexible reporting options that allow you to visualize worklog data in pivot tables or charts, making it easier to understand how time is distributed across projects, team members, and work items. For more details, see: [Worklog Reports \& Timesheets Gadget](https://documentation.stonikbyte.com/great-gadgets/worklog-reports-timesheets-gadget.md) | | ![image-20260113-135245.png](https://documentation.stonikbyte.com/__attachments/a_54555681c289052a1c8f728529c01fbae7c12599c0a62797c7d7e0a17cb5a254/image-20260113-135245.png?cb=865eb387711b8f216c94eec78dd2e10b) | project management release management | **Issue Filter Formula Gadget** Calculates and displays the result of a simple formula (like SUM, MAX or AVERAGE) on a numeric field of the issues from a specified Jira issue filter. Use this gadget to sum-up and display the total remaining work or the work done in your project, for example. On Jira Service Management, it can be used to calculate and display the Customer Satisfaction (CSAT) score. For more details, see [Issue Filter Formula Gadget](https://documentation.stonikbyte.com/great-gadgets/issue-filter-formula-gadget.md) | | ![image-20260113-134851.png](https://documentation.stonikbyte.com/__attachments/a_b94ee4a1eda78c9c4b6fa12abe80cd568cdf06abefbf7feef7631fda67fe1423/image-20260113-134851.png?cb=0bb15a30db121c1c453c196a95ba597e) | project management release management | **Advanced Issue Filter Formula Gadget** Calculates and displays the result of up to 9 math formulas applied against the numerical fields or count of the issues from a Jira filter. For example, you could use this gadget to calculate and display the percent of work done or the percent of spent budget. For more details, see [Advanced Issue Filter Formula Gadget](https://documentation.stonikbyte.com/great-gadgets/advanced-issue-filter-formula-gadget.md) | | ![image-20260113-135043.png](https://documentation.stonikbyte.com/__attachments/a_cc6b1b01b479febef1ae3ef307817d380246061709dd1a42c2f7b376f90f2bb0/image-20260113-135043.png?cb=dc87b61a7d35eea5bee58f0b1888a1a4) | project management release management TIME management | **Countdown Gadget** This gadget shows the remaining time until an upcoming event. Use this gadget to make your team aware of the remaining time until the next project launch or milestone, the Christmas Party or any other important event for your team or company. For more details, see [Countdown Gadget](https://documentation.stonikbyte.com/great-gadgets/countdown-gadget.md) | | ![image-20240618-075136.png](https://documentation.stonikbyte.com/__attachments/a_bce244a4d626648f65d1ceae0ca7acbbfaf5b7fe4f2e9c394528869aa4e4b878/image-20240618-075136.png?cb=9bf954389bd5e737d72d14ee0f1a5758) | project management release management TIME management | **Regional Clock Gadget** This gadget shows the current time in a specific location in a digital clock format. It is useful for companies with multiple offices across the world or geographically distributed teams. Use this gadget to make your team members know what the current time is in the other offices so they can better synchronize with the remote people. For more details, see [Regional Clock Gadget](https://documentation.stonikbyte.com/great-gadgets/regional-clock-gadget.md) | | ![image-20260506-094115.png](https://documentation.stonikbyte.com/__attachments/a_550cbee0b0bd8e6eb6c7892cae748cdfc84dcd8ce5a1e372cd768484ee5d8cc8/image-20260506-094115.png?cb=de5d3c49c890192573d719e98f48ca45) | project management | **Great Gadgets Controller** This gadget is a controller that lets you apply additional filtering to other gadgets on the dashboard. It's useful for visualizing charts based on a subset of issues, such as a specific project or team, without needing to create separate dashboards for each. For more details, see[Great Gadgets Controller](https://documentation.stonikbyte.com/great-gadgets/great-gadgets-controller.md) | --- language: "en" --- # Great Gadgets Controller ## Overview This is a controller gadget that lets you apply additional filtering to other gadgets on the dashboard. It's especially useful for visualizing charts based on a subset of issues, such as a specific project or team, without needing to create separate dashboards for each. This gadget is available only in Great Gadgets for Jira Cloud. ## How to Use It Currently, the filter is applied either as custom JQL or by selecting one of the predefined filters saved as presets in the gadget configuration. To apply the filtering, select one of the available presets from the dropdown (if available), or enter a custom JQL, then click **Apply**. ![Great Gadgets Controller.png](https://documentation.stonikbyte.com/__attachments/a_55d61cb6e5eeb47a7b2c595daa1ca39d4b084fa4d77c9621c91a3a6388ae65bd/Great%20Gadgets%20Controller.png?cb=53d50b3f6e12c171608d2f3399ce39cf) **IMPORTANT** * The extra filtering applied here affects only gadgets from the Great Gadgets app, not Jira's native gadgets or those from other apps. * The applied filter is temporary and will not be saved in the gadgets' configuration. * The presets dropdown is available only if at least one preset exists. ## Creating and Managing Presets In its configuration settings, the gadget allows dashboard editors to save JQL queries as presets, making filtering easier for dashboard viewers by eliminating the need to write JQL manually. To create a preset: * Go to the gadget configuration * Type the JQL query for the new present ![Controller - Type JQL query.png](https://documentation.stonikbyte.com/__attachments/a_e130908c835eef6808bef35906900a419fbf24ba29ab02895833f639fd66da60/Controller%20-%20Type%20JQL%20query.png?cb=22b15d19c86121717418c39cd77f8ab5) * Click the **Create preset** icon ![Controller---Create-preset.png](https://documentation.stonikbyte.com/__attachments/a_b84d7a3e377ab96a34be163a1abcc540c9b62216a766d787d41063d922405d7c/Controller---Create-preset.png?cb=21ca2e6c7f3c4c0880b44ebaca49bd60) * Enter a name for the new preset and click its **Save** icon ![Controller---save-preset.png](https://documentation.stonikbyte.com/__attachments/a_8f4439e18550574a8c9060afadeae03e3c95fe4cddae375aececc1e817d5f42d/Controller---save-preset.png?cb=456fb2ed9654e26c7e09fb58e1d665cb) * Click **Save** button The created presets are available to all dashboard users, but they can only be edited in the gadget configuration. Presets can be modified, cloned, or deleted by selecting the preset and clicking the appropriate icon. ![Controller---edit-save-copy-preset.png](https://documentation.stonikbyte.com/__attachments/a_2f8e89b3bc31e8523ab3d272f29282f0feccff7e7d465e21d93b15bf5df51769/Controller---edit-save-copy-preset.png?cb=f4772e04cd639d023425354cb21d1a85) When a preset is available, the gadget displays a **JQL** button. Clicking this button reveals the JQL query behind the selected preset, allowing you to view or reuse it. ![Controller---show-JQL-button.png](https://documentation.stonikbyte.com/__attachments/a_cc29b4002932b098242a5060d2c083dffedaa7a14d74ad9a4f77e79e1f0d7230/Controller---show-JQL-button.png?cb=7c0ab954214650e80f356d2e6971c2a9) If no preset is configured, the gadget displays only the JQL editor field, where you can manually enter a query to define the filter. ![Controller - JQL editor.png](https://documentation.stonikbyte.com/__attachments/a_8f7ef63245f2e7ba1445e08b30a27d4962253ea755436bda6f72417468299a02/Controller%20-%20JQL%20editor.png?cb=30823d6393b7e90d895d09327035557d) --- language: "en" --- # Histogram Chart Gadget ## Overview Depending on how you configure it, this gadget can calculate the key Kanban metrics like "Cycle Time" or "Lead Time" for the work items from a specified filter and for a certain time interval and display their distribution as a histogram. Optionally, the average cycle time can be displayed as a separate line and a custom threshold line can be added for easily identifying the work items that had an abnormally long cycle time. You can use this gadget to see how your team delivers, how many work items were resolved in the expected time frame and how many were not. ![Histogram chart gadget .png](https://documentation.stonikbyte.com/__attachments/a_63ebb5bc749270111aafceb2efca6a0e9f021643dd045017607d35176972b13d/Histogram%20chart%20gadget%20.png?cb=50ee04220a4125c9c0c91cb3a1a3197c) The gadget identifies those work items from the specified filter (or dashboard's filter) that had a cycle completed in the specified time interval, determines the cycle(s) duration and then groups them into "bins", indicating how many values fall into ranges. See the settings description below for how to configure the gadget. **Tips \& Tricks** To calculate "Cycle Time", set the following: * Cycle starts = When the work item entered a status that has category "In Progress" * Cycle ends = When the work item entered a status that has category "Done" To calculate "Lead Time", set the following: * Cycle starts = When the work item was created OR When the work item entered a status that has category "New" * Cycle ends = When the work item entered a status that has category "Done". ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Histogram chart gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_595e91a6e5a770017164ed804831cef2f3ce73a54abd28847c866ecdbc6b8f5b/Histogram%20chart%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=719e0605a689f88c6878cb18b6d17bc3) | **Setting** | **Description** | |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data source** used by the gadget: * Theagile**Board** of your team. * A**Saved filter** containing the work items for which you want the metrics to be calculated. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check **Include the sub-tasks** if you want the sub-tasks from the selected board or filter to be included in the calculation. * A **JQL** query that returns the work items you want to be processed by the gadget. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_431ff285663f39aceb1a6e50b7bb728843583d87b5aa7b1af37fe67ac3660992/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Split range criteria** | Choose how to define the segmented columns (bins). If you choose **Attempt to split in ? equal intervals** , the gadget will try to divide the range in equal intervals, although it is not always possible to split in the number of intervals that you specified. So the number that you enter is actually a "desired" number. If you choose **Split by using these custom thresholds,** the range will be divided according to the entered thresholds. In this case, you must manually introduce the thresholds separated by a comma (for example: 100, 200, 300, 400, 500). | | **Cycle starts** | Indicates what to consider as the start event of a cycle. You can choose between: * **When the work item was created** * **When the work item entered a status that has category "New"** - the cycle starts when the work item is transitioned to any workflow status of category "New". This includes those gray-colored statuses from Jira, like *New* , *Backlog* or *To Do*. * **When the work item entered a status that has category "In Progress"** - the cycle starts when the work item is transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like *In Work* , *In Progress* or *In Testing*. * **When the work item entered this status** - cycle starts when the work item was transitioned to the specified workflow status. Choose also how to handle the case when there are multiple transitions to the start status or to the status category by setting **If multiple entries in the start status, consider the ? entry** to *first* or *last*. See the example below. **Example** You configured the gadget to start the cycle **When the work item entered a status that has category "In Progress"** and to end the cycle **When the work item entered a status that has category "Done"** and there was a Jira work item that had multiple entries in the "In Progress" status before being moved to "Done". How should the cycle time be calculated, from the first or from the last transition in the "In Progress" status? ![image-20240618-081328.png](https://documentation.stonikbyte.com/__attachments/a_cd62d1573d8eb38dc28c2d355b8dc0eea215952ef6eabc0ca87aa4942290f541/image-20240618-081328.png?cb=b0f126a479d8f1760c43de2d47f0d44e) If you set **If multiple entries in the start status, consider the** ***first*** **entry**, the cycle will start when the work item was transitioned to the "In Progress" status for the first time. ![image-20240618-081337.png](https://documentation.stonikbyte.com/__attachments/a_531e2407ce1ca328d7bc28dead6b5c8a36b6e209a3bb16f6db64637e9e4d16c2/image-20240618-081337.png?cb=53e04adbc5b13f042a2e4b293d0a7dcc) If you set **If multiple entries in the start status, consider the** ***last*** **entry,** the cycle will start when the work item was transitioned to the "In Progress" status for the last time. ![image-20240618-081348.png](https://documentation.stonikbyte.com/__attachments/a_f552aaed3f58f148dcf68188b97e6ff786f74124c44a44ade9a3acf9ca350d50/image-20240618-081348.png?cb=7ff46a676677a99504dab4da71e827a5) | | **Cycle ends** | Indicates what to consider as the end event of a cycle. You can choose between: * **When the work item entered a status that has category "Done"** - the cycle ends when the work item was transitioned to any workflow status of category "Done". This includes those green-colored statuses from Jira, like *Done* , *Resolved* or *Closed*. * **When the work item entered a status that has category "In Progress"** - the cycle ends when the work item was transitioned to any workflow status of category "In Progress". This includes those blue-colored statuses from Jira, like *In Work* , *In Progress* or *In Testing*. * **When the work item entered this status** - the cycle ends when the work item was transitioned to the specified workflow status. You can also choose how to handle the case when there are multiple transitions to the end status by setting **If multiple entries in the end status, consider the ? entry** to *first* or *last*. See the example below. **Example** You configured the gadget to start the cycle **When the work item entered a status that has category "New"** and to end the cycle **When the work item entered a status that has category "Done"** and there is a Jira work item that had multiple entries in the "Done". How should the cycle time be calculated, till the first or till the last transition in the "Done" status? ![image-20240618-081400.png](https://documentation.stonikbyte.com/__attachments/a_855594bcb9f565f70dc42770344e6df871b6c95360150750a8ec928bb01a7cdc/image-20240618-081400.png?cb=092855c79ce8814068530d9040b64d54) If you set **If multiple entries in the end status, consider the** ***first*** **entry**, the cycle will end when the work item was transitioned in the "Done" status for the first time. ![image-20240618-081411.png](https://documentation.stonikbyte.com/__attachments/a_df5ca5e40f2117a191c1dc6ee16bfb2b4c132460d4b00db942f5fa15b5f8883a/image-20240618-081411.png?cb=78f136920c9f6127e0b54af08476eef9) If you set **If multiple entries in the end status, consider the** ***last*** **entry**, the cycle will end when the work item was transitioned in the "Done" status for the last time. ![image-20240618-081421.png](https://documentation.stonikbyte.com/__attachments/a_0bfc32043d9ce7cfccdfe31943e14617bc86f99414dbc6d777377182bb87c2e9/image-20240618-081421.png?cb=8ae0d89e8f4a9bafe6c82847af47c94d) | | **Multiple cycles** | Decide how the gadget should handle those Jira work items that have multiple cycles. This situation occurs if the work item was transitioned multiple times through the start and the finish statuses of the cycle. **Example** You configured the gadget to start the cycle **When the work item entered a status that has category "In Progress"** and to end the cycle **When the work item entered a status that has category "Done"** and there was a Jira work item that was moved from "In Progress" to "Done" multiple times, so it had multiple cycles. What cycle do you want to be displayed? ![image-20240618-081433.png](https://documentation.stonikbyte.com/__attachments/a_524591c6159221a73d25935c4d9ea569eaac5a96429115946bed1ced96b4c9b6/image-20240618-081433.png?cb=9ac434fe0cd51313821569310ae13056) You can choose between: * *Display all cycles* - all the cycles will be displayed with their own dot in the plotting chart and their own entry in the data table. * *Display only the first cycle* - only the first cycle of the work item will be displayed, with all the others being ignored * *Display only the last cycle* - only the last cycle of the work item will be displayed, with all the others being ignored * *Display as one cycle from the start time of the first cycle to the finish time of the last cycle* - a single cycle will be displayed, having as the start time the moment when the first cycle started and as the finish time the moment when the last cycle ended. See the picture below. ![image-20240618-081441.png](https://documentation.stonikbyte.com/__attachments/a_8bfeb899b6aec057d2dfa670545cb72d483af812b6c96651f73a06f11dfd3b71/image-20240618-081441.png?cb=42da8a1ab8aa4abdda6d9bd5c5c6bea2) * *Display as sum of all cycles* - a single cycle will be displayed, with the start time being the moment the first cycle started and the end time being the moment the last cycle ended, and its duration calculated as the sum of all cycles. | | **Time interval** | Represents the time interval displayed by the gadget. You can choose from multiple options: **Custom dates** - choose this option if you want to manually enter a *Start date* and an *End date*. **A number of days back** - By choosing this option, the gadget will use a rolling time interval with a number of days back to the current day. **Dates of a project release** - Choose this option if you want the gadget to use the start and end dates of an existing space release (added on the Releases page of a Jira space). Make sure the selected release has a *Start date* and *End date* set. Any subsequent changes to the release dates made on the space's Releases page will be automatically reflected in the gadget, without the need to reconfigure it. **Dates of a sprint** - Choose this option if you want the gadget to use the start and end dates of an existing sprint. Only the dates are considered (not also the hours). The start of the interval will be the start date of the sprint with time at the start of day, while the end of the interval will be the end date of the sprint with the time at the end of day. When enabled, you'll need to select the board the sprint belongs to. If you choose the *Latest sprint (auto)* , the date range will automatically match the most recent sprint. If you choose the *Previous sprint (auto)*, the date range will automatically match the sprint immediately before the latest one. If you manually select a specific sprint, any changes made to its dates on the board will be automatically reflected in the gadget, without the need to reconfigure it. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Histogram chart gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_b3d81bdd44cfc7677a23592b926e6bf60108d887fce236c6cf72f26673fceda1/Histogram%20chart%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=aca37f0ec983b55627d4e8672d51afc7) | **Setting** | **Description** | |-----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Calculate the cycle time in** | Specify in what time unit measure the cycle time will be calculated and displayed. | | **Don't count weekends** | Check this option if you want to exclude the weekends (Saturdays and Sundays) from the cycle time calculation. | | **Display average line** | Check this option if you want the chart to display a vertical line with the average cycle time for the specified time interval. | | **Exclude breaches from average calculation** | Check this option if you want the average calculation to exclude work items that exceeded the set threshold (breaches). This option has no effect if no threshold is set. | | **Display threshold line** | Check this option if you want the chart to display a vertical line representing a threshold. The work items that have a cycle time higher than the specified **Threshold** value will be colored in red. | | **Display percentile lines** | Check this option and enter the values (percents) corresponding to the percentiles to be displayed as vertical lines. A percentile is a value from the data set that splits the data into two pieces: the lower piece contains the percent of the data, and the upper piece contains the rest of the data. For example, the 75% percentile will be displayed as a horizontal line with 75% of the work items under it and the rest of the work items (25%) over it. | | **Show percentage/count above each column** | Check this option if you want the gadget to display values above each column in the chart. You can choose from three display formats: * **Percentage**: the gadget will display the percentage of work items in each range relative to the total number of work items in the chart. * **Count:** the gadget will display the total number of work items in each range. * **Count \& percentage:** the gadget will display both the number of work items in each range and their percentage of the total. | | **Show legend** | Check this option if you want the chart legend to be displayed. | | **Show data table** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays the work items along with their cycle time details and the average calculation. ![Histogram-chart-gadget---data-table.png](https://documentation.stonikbyte.com/__attachments/a_9299ec3e215369b2d0c5949f8207ac9c0d4282f1196b431deef0c6203003285e/Histogram-chart-gadget---data-table.png?cb=a7e3d3afbaa07882613242a9d63613fa) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Histogram chart gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_688695cea49860261e1f4eb43f3f35958faf2f33c6dd72280c7a79beeb268370/Histogram%20chart%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=cf18d87c68858920c6380d25ac490ccc) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [How to measure Cycle Time and Lead Time in Jira or Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/10/02/how-to-measure-cycle-time-and-lead-time-in-jira-or-confluence-with-great-gadgets-app/) * [SLA Breaches in Jira: What they are, why they happen and how to track and prevent them using Great Gadgets for Jira](https://blog.stonikbyte.com/2025/06/20/sla-breaches-in-jira-what-they-are-why-they-happen-and-how-to-track-and-prevent-them-using-great-gadgets-for-jira/) --- language: "en" --- # How to Create a Sprint Burndown in Jira That Includes Sub-Tasks If you've ever tried to rely on Jira's default sprint burndown chart gadget or report, you've probably run into this frustration: **it doesn't include subtasks** - which means your team's actual progress might look slower than it really is. This limitation leads to misleading reports and unnecessary confusion during sprint reviews. Many teams try to fix this by exporting work items to Excel or building manual calculations, but that's neither efficient nor scalable. Luckily, with [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks) app, there's a better way to get a complete, accurate sprint burndown (and even a burnup) chart that includes subtasks - right inside Jira. ## Why Jira's Native Sprint Burndown Chart is Insufficient Jira's built-in sprint burndown chart gadget or the sprint report are designed to count only the parent work items (like Stories or Tasks) and don't automatically include subtasks in the calculation. Jira's burndown logic assumes that work only progresses when entire stories are marked "done". This means that even if a team completes 80% of subtasks, the chart won't move until the parent work item is closed. As a result: * subtasks completed during the sprint don't affect the burndown line; * the sprint appears "stuck" even though work is actually progressing; * teams loses visibility into detailed task progress. So, if your team breaks work into subtasks and also assigns estimates to them, Jira's built-in burndown chart may not be sufficient for more detailed, day-to-day tracking. ## How to Include Subtasks in a Sprint Burndown (with Great Gadgets App) Luckily, there's a better way (and it doesn't involve Excel). [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks) app offers a [Sprint Burndown Burnup Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/sprint-burndown-burnup-chart-gadget.md) that brings advanced sprint tracking directly into Jira dashboards. With it, you can create burndown (and burnup) charts that include subtasks, use custom calculations, and visualize sprint progress in real-time. When it comes to subtasks, the gadget can be configured to **include the subtasks** along with the parent stories, or to **process** ++**only**++ **the subtasks**. Let's see how. ### **Here's how to set up the Sprint Burndown Burnup Chart:** #### **1. Add the Sprint Burndown Gadget to your dashboard** * Make sure you already have Great Gadgets app installed in your Jira instance. If not, you can install it from the Atlassian Marketplace: [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks), [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks), [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks). * Go to your Jira dashboard and click **Add Gadget**. * Search for **Sprint Burndown Burnup Chart** and click **Add**. ![How-to-add-sprint-burndown-burnup-chart-to-a-Jira-dashboard.gif](https://documentation.stonikbyte.com/__attachments/a_e1344ccff2683a6dddef565a475c14063311913011a0331cac8117288249de4f/How-to-add-sprint-burndown-burnup-chart-to-a-Jira-dashboard.gif?cb=9b11c93ef2434a2ee4a7cac5e74106e7) #### **2. Configure the Gadget** * Select the **board** that includes your work items. * Choose the**latest sprint** (or select a **past sprint** if you want) * Set the **estimation method**. The gadget supports multiple estimation methods, such as story points, time estimates, work item count, or any other numerical custom field. * **Include the subtasks in the calculation** . At **Subtasks** section, select the **Include the subtasks** option. If you want the gadget to show **only** the subtasks then select the **Process only the subtasks** option. ![Sprint-Burndown-Burnup-Chart-include-subtasks-option.png](https://documentation.stonikbyte.com/__attachments/a_dcc290450cbbc560698fc70b577a60d5f3ca415d2c451d4de9c724132980d450/Sprint-Burndown-Burnup-Chart-include-subtasks-option.png?cb=326285a7276602daa55b9168fddfd242) * Choose the series to be displayed * To display a burndown chart check **Ideal Burndown** , **Remaining** and **Scope** * To display a burnup chart check **Ideal Burnup** and **Burned** ![How-to-configure-burndown-chart-to-include-subtasks.png](https://documentation.stonikbyte.com/__attachments/a_cd653c3fbb1c353de054981fa642c9f806b5fcc5e567d9af4ae9a00a33dd13f8/How-to-configure-burndown-chart-to-include-subtasks.png?cb=5603afcba49d4bd951fff98143da2b6e) ## **The Result: A Complete and Accurate Sprint Burndown In Jira That Includes Subtasks** Once configured, your burndown chart will now reflect **real progress**, including all subtasks completed during the sprint. ![Sprint Burndown Chart with subtasks.png](https://documentation.stonikbyte.com/__attachments/a_ede3c2ba584ae3d99a834dafd756a56f9790081c5ff3b064647ab05b1faa6ba2/Sprint%20Burndown%20Chart%20with%20subtasks.png?cb=e21f1e343a5ed85f3bf7c19072bd9b6c) You can easily see how much work remains, how the team is performing, and whether you're on track to finish the sprint goals. In addition to the visual chart, if you checked the option **Show data tab** on the **More Settings** tab, the gadget also displays a **Data tab** containing a detailed sprint report based on the current status, which displays the subtasks from the sprint. This report includes all completed and not-completed work items, providing a clear summary of the sprint's progress at any moment. You can also **export this data to CSV format** for further analysis, sharing with stakeholders, or including in sprint review documentation. ![Sprint-Burndown-Chart-Data-tab-showing-completed-and-not-completed-issues-with-CSV-export-option-and-subtasks-highlighted.png](https://documentation.stonikbyte.com/__attachments/a_78e446962d6b7e654299f6674d2ee854bcea801d337e5ef0d60195095e8d6dd3/Sprint-Burndown-Chart-Data-tab-showing-completed-and-not-completed-issues-with-CSV-export-option-and-subtasks-highlighted.png?cb=dd3718873ffa75fe4e883686c988fb9b) 💡 **Tip:** What's even more useful is that you can also configure this gadget as a **burnup chart** (which Jira doesn't offer natively) - perfect if you want to visualize sprint progress in terms of work completed over time rather than work remaining. ![Sprint Burnup Chart with subtasks.png](https://documentation.stonikbyte.com/__attachments/a_148bb3a1fb0110151582df5a6dc1e7d779ed0a2f3d2f73c6ee4df173ad62ea50/Sprint%20Burnup%20Chart%20with%20subtasks.png?cb=96f6ad34bc9029d9b0a7fe465e6ffd4d) ## **Why It Matters** With subtasks included, your burndown chart becomes a true reflection of sprint progress. No more under-reported velocity, confusing sprint reviews, or manual Excel fixes. This clarity helps Scrum Masters and Project Managers make better decisions, run more effective retrospectives and keep everyone informed - without ever leaving Jira. ### **Does Great Gadgets app offer other gadgets with support for subtasks?** Yes. Great Gadgets offers many other gadgets that can process the subtasks: **Team Velocity** gadget, **Release Burndown Burnup Chart** gadget, **Cumulative Flow Diagram (CFD)** gadget, **Control Chart** gadget and many more. Combined with your **Sprint Burndown Burnup Chart**, this gives you all you need to build a powerful reporting dashboard for your Scrum project where you can: * Track sprint progress and remaining work in real time. * Measure your team's velocity across multiple sprints. * Compare actual vs. planned performance. * Visualize how consistent your team's delivery is. **Still not convinced?** Our customer say that "*This app brilliantly overcomes Jira's limitations.*" - Atlassian Marketplace review 👉 **Try Great Gadgets free for 30 days and see the difference for yourself!** * [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks) * [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks) * [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_create_sprint_burndown_with_subtasks) ## **FAQ** **Q: Can I include subtasks in the Jira burndown without an app?** No, Jira's native chart doesn't support subtasks. Great Gadgets adds this functionality through dashboard gadgets. **Q: Does this work for Kanban projects?** For Kanban use gadgets like Release Burndown Burnup Chart, [++Control Chart++](https://documentation.stonikbyte.com/great-gadgets/control-chart-gadget.md), [++Kanban Velocity/Throughput++](https://documentation.stonikbyte.com/great-gadgets/kanban-velocity-gadget.md), [++WIP Run Chart++](https://documentation.stonikbyte.com/great-gadgets/wip-run-chart-gadget.md), [++WIP Aging Chart++](https://documentation.stonikbyte.com/great-gadgets/wip-aging-chart-gadget.md), [++Cycle Time Trend Chart++](https://documentation.stonikbyte.com/great-gadgets/cycle-time-trend-gadget.md), [++Histogram Chart++](https://documentation.stonikbyte.com/great-gadgets/histogram-chart-gadget.md) or [++Cumulative Flow Diagram++](https://documentation.stonikbyte.com/great-gadgets/cumulative-flow-diagram-cfd-gadget.md) that can also include the subtasks in the calculation. **Q: Is there a gadget to track team velocity based on subtasks?** Yes! The [++**Team Velocity Chart**++](https://documentation.stonikbyte.com/great-gadgets/team-velocity-gadget.md) gadget from **Great Gadgets** lets you include subtasks in velocity calculations and visualize sprint trends side by side on your dashboard. For Kanban projects, you can use the **Kanban Velocity / Throughput** gadget offered by the same app. ## Related Resources: * [Sprint Burndown Burnup Chart Gadget](https://documentation.stonikbyte.com/great-gadgets/sprint-burndown-burnup-chart-gadget.md) * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * ![youtube_5968852.png](https://documentation.stonikbyte.com/__attachments/a_abe03550802e279f0ec0ac7639c732a348a6b1e329fc3b10639ba00efb8f620c/youtube_5968852.png?cb=642bfb077a5c99b6564f979578900c53) [How to display a Sprint Burndown Burnup chart with sub-tasks in Jira](https://www.youtube.com/watch?v=bCMc0grTmmw) --- language: "en" --- # How to install and configure Great Gadgets ## Installing and configuring Great Gadgets in Jira Cloud Follow these steps to install and configure Great Gadgets in your Jira Cloud instance: 1. Go to [https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud\&tab=installation](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=installation) and log in with your Jira admin account. ![image-20260417-103720.png](https://documentation.stonikbyte.com/__attachments/a_2897796b1d07fffc800a9fe48be61810f90baaa5a6cc30dc5942ca147392a892/image-20260417-103720.png?cb=291fea00d94458bb9d808465e7a8ed3f) 2. Click **Try it free** to start the installation process. 3. Select the app edition and choose the Atlassian site where you want to install the app. 4. Follow the on-screen instructions to complete the installation. Complete the post-install configuration: 5. (Optional) Enable data residency. For details, see: [Data Residency](https://documentation.stonikbyte.com/great-gadgets/data-residency.md). 6. If your Jira Cloud instance uses IP allowlists, add the app IP addresses to your allowlists. For more information, see: [Technical Notes \| IP Allowlisting](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md#IP-Allowlisting). Once these steps are complete, the app is configured and ready to use. For more information, see: [How to use Great Gadgets \| Using the gadgets in Jira](https://documentation.stonikbyte.com/great-gadgets/how-to-use-great-gadgets.md#Using-the-gadgets-in-Jira). ## Installing and configuring Great Gadgets in Confluence Cloud Follow these steps to install and configure Great Gadgets in your Jira Cloud instance: 1. Go to [https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud\&tab=overview](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview) and log in with your Confluence admin account. ![image-20260417-105242.png](https://documentation.stonikbyte.com/__attachments/a_1cabd31601d17f0ff0ec39e7fa326b4005838494fb1eefa373dd2131ccba4ef0/image-20260417-105242.png?cb=3fd91274d77f8906eec0e8732c8a68fc) 2. Click **Try it free** to start the installation process. 3. Select the app edition and choose the Atlassian site where you want to install the app. Choose to also connect the app to Jira and Jira Service Management (if available). 4. Follow the on-screen instructions to complete the installation. Now ensure that the app is connected to your Jira Cloud instance. This step is required because most app macros rely on Jira data and need access to retrieve it. 5. Go to **Confluence Administration** \> **Settings** \> **Atlassian Marketplace** \>**Manage apps** , then click **Take me there** to be redirected to **Connected Apps** in the Administration section. 6. Click **View app details** for *Great Gadgets for Confluence*. 7. Open the **Connections** tab and under **Jira Apps** , click **Connect** (if it is not already connected). ![image-20260417-114800.png](https://documentation.stonikbyte.com/__attachments/a_f36e89a80eff4d3ffabad3ec7f2b539c7f3656cdb177cb1bed68c684b3881714/image-20260417-114800.png?cb=53e2e566db5162e665986f20482a052b) Complete the post-install configuration: 9. (Optional) Enable data residency. For details, see: [Data Residency](https://documentation.stonikbyte.com/great-gadgets/data-residency.md). 10. If your Jira Cloud instance uses IP allowlists, add the app IP addresses to your allowlists. For more information, see: [Technical Notes \| IP Allowlisting](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md#IP-Allowlisting). Once these steps are complete, the app is configured and ready to use. For more information, see: [How to use Great Gadgets \| Using the gadgets in Confluence Cloud](https://documentation.stonikbyte.com/great-gadgets/how-to-use-great-gadgets.md#Using-the-gadgets-in-Confluence-Cloud). --- language: "en" --- # How to Track Total or Average Time In Status in Jira Dashboards Understanding how long work items spend in each workflow status is critical for teams of any kind, whether using agile or not. It is a key factor in planning, monitoring and improving team and workflow performance. In this guide, you'll learn how to configure the [Time In Status gadget](https://documentation.stonikbyte.com/great-gadgets/time-in-status-gadget.md) from [++Great Gadgets++](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status) to create real-time dashboards that adapt to any workflow, team or role --- helping you analyze efficiency and spot bottlenecks directly in Jira. ## The Challenge: Why Time-in-Status Tracking is Limited in Jira Jira offers some native options to track time in status, but they have limitations: * **Average Time In Status gadget:** Provides a basic visualization of the average time spent per status, but lacks flexible grouping, aggregation and advanced visualizations. * **Days in Column (on boards):** Displays approximate days in status using dots on work item cards. Requires Jira admin access to enable, cannot exclude weekends and only shows days, not precise hours. But if teams look for a unified view in Jira dashboards, this can't be achieved using only the built-in solutions. Therefore, teams cannot easily identify workflow bottlenecks, compare performance across projects or create dashboards that reflect real efficiency. ## The Solution: Time In Status Gadget offered by Great Gadgets The [Time In Status gadget](https://documentation.stonikbyte.com/great-gadgets/time-in-status-gadget.md)solves these challenges by providing a fully configurable and very efficient way to measure time in status, helping teams gain actionable insights. It can: * Measures how long each work item stays in a workflow status, status category or board column. * Calculate total time or average time in hours, days or minutes. * Calculate the subtasks. * Include or exclude specific statuses or status categories. * Group data by assignee, project, priority or other custom fields. * Display results as pie chart, bar chart, column or stacked column charts. * Help identify the slow parts of the workflow and understand team performance. ### **Here's how to set up the Time In Status gadget:** #### **1. Add the Time In Status gadget to your dashboard** * Make sure you already have Great Gadgets app installed in your Jira instance. If not, you can install it from the Atlassian Marketplace: [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status), [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status), [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status). * Go to your Jira dashboard and click **Add Gadget**. * Search for **Time In Status gadget** and click **Add**. ![How-To-Add-Time-In-Status-Gadget-to-Jira-Dashboards.gif](https://documentation.stonikbyte.com/__attachments/a_78d0b71d5a87210d398d7fb00a1d94025b4ca4ee96a7366a00ab8dff3e6b586f/How-To-Add-Time-In-Status-Gadget-to-Jira-Dashboards.gif?cb=bc352f3d2ec6854dbbf895f50b200772) #### **2. Configure the Gadget** * Select a **board** , a **filter** or enter a **JQL** that returns the work items you want * Select what to measure: time in status, time in status category or time in columns of the selected board * Select to calculate the **Total Time** or **Average Time** * Optionally, you can choose a grouping criteria such as assignee, project, priority or custom fields * Select **visualization type**: pie, bar, column or stacked column chart ![Time-In-Status-gadget-configured-as-a-pie-chart-and-to-calculate-the-total-time-in-status.png](https://documentation.stonikbyte.com/__attachments/a_d5eaed8ce842ccc1322662fe95211ef994423e98771cc77d6a01be06db5c49b1/Time-In-Status-gadget-configured-as-a-pie-chart-and-to-calculate-the-total-time-in-status.png?cb=200cca86e79996d62a7e158917d1717c) * In the **More Settings** tab further customize the gadget ![More-Settings---Time-In-Status-gadget-configured-as-a-pie-chart-and-to-calculate-the-total-time-in-status.png](https://documentation.stonikbyte.com/__attachments/a_744531cc3cb141e7f5ffb6742550b3bd55f8959538663719aadda09998cbfe2e/More-Settings---Time-In-Status-gadget-configured-as-a-pie-chart-and-to-calculate-the-total-time-in-status.png?cb=dad9c0287660931d569346de7fb029d9) ## The Result: Understand Time In Status at a Glance Once configured, the Time In Status gadget helps you quickly understand where work items are spending the most time and which workflow step may be causing delays. ![Time In Status - total time in status in hours.png](https://documentation.stonikbyte.com/__attachments/a_9443444c903856f98087e2c4d0e8d051ced9a577c3a923c247cbe6935bd1ef7f/Time%20In%20Status%20-%20total%20time%20in%20status%20in%20hours.png?cb=5876d5ee0530bdd9b1e1d99ffa8e37a8) * View how long work items stay in each workflow step * Identify which parts of the workflow takes the most time or slows-down the flow * Understand team performance across projects, or the performance of each team member 💡 **Tip:** Make your dashboards truly reflect your workflow by combining grouping and chart types. ![Dashboard-with-Time-in-status.png](https://documentation.stonikbyte.com/__attachments/a_1cb9393309cb72f4a930e7b9220932ba47a8ea1b6d6dd8019ff4d25cae7d9665/Dashboard-with-Time-in-status.png?cb=ba028d7612d112607e425bd78b715c08) In addition to the visual chart, if you checked the option **Show data tab** on the **More Settings** tab, the gadget also displays a **Data tab** containing a detailed breakdown of time spent in each status for each work item. With one click, the data can be **exported to CSV**, giving teams a flexible way to review or report the information outside the dashboard. ![Time-In-Status-Data-Tab.png](https://documentation.stonikbyte.com/__attachments/a_54577144b039a9ce17945bd783621b20da328c34f1ba3e13f7909055f1f53076/Time-In-Status-Data-Tab.png?cb=2f98fd2d60dcd0c27e6c8de203afc299) 💡 **Tip:** This gadget is fully configurable for any workflow and can be embedded as a macro in Confluence for reporting. ## **Why It Matters** Tracking time in status isn't just about metrics --- it's about improving performance, optimizing flow, reducing delays and making data-driven decisions. Using this gadget helps teams and managers: * **Identify the slowest parts of the workflow** --- see what parts should be optimized. * **Understand team performance** --- see who delivers fast and who delivers slow. * **Create custom dashboards for every role** --- everyone sees the metrics they need. **Still not convinced?** Our customer say that "*This app brilliantly overcomes Jira's limitations.*" - Atlassian Marketplace review 👉 **Try Great Gadgets free for 30 days and see the difference for yourself!** * [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status) * [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status) * [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Track_Total_or_Average_Time_in_Status) ## **FAQ** **Q: Can I see both total and average time in the Time In Status?** Yes! The Time In Status gadget allows you to switch between total time and average time, depending on the insights you need. **Q: Can I see total or average time in status by assignee, project or custom fields?** Absolutely. You can configure grouping to visualize the metrics by assignee, project, priority or any custom field. **Q: Can I visualize the time in status data in different chart types?** Yes! The gadget supports pie, bar, column and stacked column charts, so you can pick the best format for your team or stakeholders. **Q: Can I export a Time in Status report with a detailed list of work items?** Yes! The Data tab of the gadget displays a detailed report with all the work items and their time in every status of the workflow, which can be exported to CSV format. **Q: Can Great Gadgets measure other advanced flow metrics like cycle time or lead time?** Absolutely. The app also offers complementary gadgets to the Time in Status gadget that enable measuring advanced flow metrics such as cycle time, lead time, time between statuses, as well as histograms, trends, and percentiles. These include the Control Chart gadget, Histogram Chart gadget, and Cycle Time Trend gadget. **Q: Is Great Gadgets a good choice for measuring time in status?** Great Gadgets is certainly one of the best options for measuring time in status and flow metrics overall. It's a strong choice if you're looking for clear, dashboard-level visibility into time-in-status and prefer an all-in-one gadget pack that offers much more than just time-in-status reporting, rather than a highly specialized time-in-status app. ## Related Resources: * [Time in Status Gadget](https://documentation.stonikbyte.com/great-gadgets/time-in-status-gadget.md) * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [7 Essential Team Performance Metrics To Track In Jira By Using Great Gadgets App](https://blog.stonikbyte.com/2025/08/14/essential-team-performance-metrics-to-track-in-jira-by-using-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * ![youtube_5968852.png](https://documentation.stonikbyte.com/__attachments/a_2e8ff24d0108422f0538dfe221f2f5d627bd6b9930d75370163e0b0006c44643/youtube_5968852.png?cb=642bfb077a5c99b6564f979578900c53) [How to Track Total or Average Time In Status in Jira Dashboards](https://www.youtube.com/watch?v=KSJJGQtUfP8&t=1s) --- language: "en" --- # How to use Great Gadgets ## Overview Great Gadgets app consists in a suite of gadgets that you can use in your Jira dashboards and/or Confluence pages. All the gadgets support the wallboard visualization mode of the Jira dashboards. See more details below on how to use the gadgets in Jira and Confluence and what you need to have installed for each case. ## Using the gadgets in Jira Once you installed and configured the app (see [How to install and configure Great Gadgets](https://documentation.stonikbyte.com/great-gadgets/how-to-install-and-configure-great-gadgets.md)), you can start using the dashboard gadgets. To add a gadget to a dashboard: * In Jira, go to Dashboards * Create a new dashboard or select an existing one * Click the **Add gadget** button of the dashboard * In the "Add a gadget" screen, filter by "great" or "StonikByte" to display all the gadgets of the app ![image-20240618-074833.png](https://documentation.stonikbyte.com/__attachments/a_dbf4881d77931bca4bf4d1c08201d88c6e756e3381bd6f5b5c63765afef6d58c/image-20240618-074833.png?cb=acb9f602c872b6499aefebcb5b9590cc) * Click the "Add gadget" button of the gadget that you want to add * Once you added the gadgets, close the "Add a gadget" screen and continue by entering the gadget settings. See below the instructions for how to configure the gadgets. ## Using the gadgets in Confluence Cloud For using the gadgets in Confluence Cloud you have to install [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-cloud?tab=overview&hosting=cloud) in your Confluence Cloud instance. Once installed, this app makes all the gadgets available as macros in your Confluence Cloud instance. Most of the macros are based on data taken from Jira. For these macros to work, you must ensure that the app is connected to your Jira Cloud instance (see [Installing and configuring Great Gadgets in Confluence Cloud](https://documentation.stonikbyte.com/great-gadgets/how-to-install-and-configure-great-gadgets.md#Installing-and-configuring-Great-Gadgets-in-Confluence-Cloud)). To insert a macro into a Confluence page: * Start editing the page where the macro will be inserted * Click the "Insert" icon from the top menu bar and start searching for the macro that you want to insert. Search by the gadget name, or for "Great Gadgets" or "StonikByte" to display all app macros. ![Search and add macros in confluence pages.png](https://documentation.stonikbyte.com/__attachments/a_cb9b59dad8dfd3aa37d0a9356abbc7380a997dc71bd0087c1f89a855d5fcdfad/Search%20and%20add%20macros%20in%20confluence%20pages.png?cb=7cc686a4c6cef18a8598206a2d898681) * Or, within the page, type "/" followed by the gadget name. ![image-20260323-144249.png](https://documentation.stonikbyte.com/__attachments/a_43bd1e239e0e54d4e46e233b490c73c02be6fd6ebf3b7ea9f1ac5726202a2310/image-20260323-144249.png?cb=2d02a6d62db66b574ab31cb86612d3c4) * Continue by entering the macro settings. See below the instructions for how to configure the gadgets. ![image-20260417-124619.png](https://documentation.stonikbyte.com/__attachments/a_21c9248bf5a6afe8c64d0e57d1e4ff7570c1b1e6ab6d6733791fc06b645dcce4/image-20260417-124619.png?cb=7950812833931560551fe37b9bf2b3d5) * When done, click the **Save** button from the macro's settings screen. The macro will be displayed on the Confluence page. ![Release Burndown Chart gadget displayed in Confluence.png](https://documentation.stonikbyte.com/__attachments/a_ae8359af3152aae54d8232e4a66d251a19a319d81f4cf463b8bfba6d959e3ae5/Release%20Burndown%20Chart%20gadget%20displayed%20in%20Confluence.png?cb=44918069383c87d104f8bf72700e827d) To edit an existing macro from a Confluence page: * Start editing the page that contains the macro * Hover the mouse pointer over the macro and click the **Edit** icon ![Edit-a-gadget-in-Confluence.png](https://documentation.stonikbyte.com/__attachments/a_fedae7bb70f884dcf83c89e2732381b11b5b0403c4d0dc9d8ac31d7ec0c4a172/Edit-a-gadget-in-Confluence.png?cb=371e462aacc3e30087a11df2eb67521e) * Edit the macro settings. See below the instructions for how to configure the gadgets. * When done, click the **Save** button from the macro's settings screen. The macro will be displayed on the Confluence page according to the new settings. ## Using the gadgets in Confluence Data Center If you have Jira Data Center with [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-server?hosting=datacenter&tab=overview) installed, you can use its gadgets as macros in Confluence Data Center. All you have to do is to import the gadgets from Jira as macros in Confluence. Follow the Atlassian documentation on how to make the gadgets available in Confluence: . If you have Confluence 9.2 or later, you will need the app [https://marketplace.atlassian.com/apps/1235676/gadgets-for-confluence?hosting=datacenter\&tab=overview](https://marketplace.atlassian.com/apps/1235676/gadgets-for-confluence?hosting=datacenter&tab=overview) to be installed on your Confluence instance in order to import Jira gadgets as macros. See on how to install this app. **IMPORTANT** There is a known issue that prevents this feature to work in environments that are configured to use Single Sign On (SSO). The solution is to make the additional settings described here[Technical Notes \| Additional Settings for Using Macros in Confluence Data Center with SSO Enabled](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md#Additional-Settings-for-Using-Macros-in-Confluence-Data-Center-with-SSO-Enabled) . ## Using the gadgets in wallboard mode In Jira, you can display the gadgets in wallboard mode to make them visible on big TV screens as information radiators, for example. ![image-20240618-074916.png](https://documentation.stonikbyte.com/__attachments/a_01a365b0dabf5fb05877538e4211d283d6dd8d300fadcc5ed5129dde5bd82d62/image-20240618-074916.png?cb=9b742966d3693fdbed0aead1d02a7de9) To trigger the wallboard mode, click the **View as wallboard** option of the Jira dashboard's menu. ![Artboard 3.png](https://documentation.stonikbyte.com/__attachments/a_e0bae64149c8bd5b7acdbb54a4e8ce07be40ccae4aaee728c2e100c2acdca359/Artboard%203.png?cb=d8be53bd46b90e5dae4a1b936d68a84c) ## Dark Theme Support The application fully supports Dark Theme mode in both Cloud and Data Center. ## Supported languages The app for Jira Cloud and Confluence Cloud is fully localized in English, Spanish, French, Portuguese, German and Romanian. For on-screen texts to appear localized, the Jira user must have one of these languages enabled in their Jira profile. Otherwise, they will be displayed in English. ## Usage examples More examples of use of Great Gadgets can be found on . --- language: "en" --- # How to Visualize Linked Issues and Their Status in Jira Dashboards If you ever tried to visualize the status of linked issues in your Jira dashboard, you may have discovered that there is no default gadget that can help you achieve that. In daily operations, teams need to quickly answer questions like: * *What is this issue blocked by?* * *Which related tasks are still open?* * *Is any dependency holding up progress?* Unfortunately, Jira does not provide a dashboard gadget that shows issues together with their linked items and their current status in a single, consolidated view. This leaves teams wasting time struggling to find workarounds but always ending up wondering: *"How can I see the linked issues status in a dashboard?"* This guide shows you how to achieve exactly that --- by using the [Work Breakdown Structure (WBS)](https://documentation.stonikbyte.com/great-gadgets/work-breakdown-structure-wbs-gadget.md) gadget from [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status)app. ## The Problem: No Build-in Gadget To Display Linked Issues Status In Dashboards Jira allows you to link issues (is blocked by, blocks, relates to, clones, duplicates, etc.) so you can map dependencies or relationships, but they are only visible inside the issue detail screen. This means that you cannot see linked issue statuses without opening each individual issue. You could try using the Filter Results gadget to display the linked issues, but it does not offer any information on the status of the linked issues (only the status of the parent issue). This leaves project managers, product owners and team leads without the visibility they need to understand the real structure of the work. ## How To Display The Status Of The Linked Issues In One View On Jira Dashboards Great Gadgets offers the [Work Breakdown Structure (WBS) gadget](https://documentation.stonikbyte.com/great-gadgets/work-breakdown-structure-wbs-gadget.md) that delivers exactly what Jira is missing: A clean, consolidated view of all linked items and their status. With the **Work Breakdown Structure gadget from Great Gadgets**, you finally get a way to: * Display linked issues * See their status instantly * Understand dependencies * Visualize the entire structure of your work The**Linked Issues View** visualization mode in the Work Breakdown Structure gadget lets you visualize all linked items directly under their associated work items, along with their status. 💡You get a fully navigable structure of all related work --- right on the dashboard. **Here's how to display linked issues and their status using the Work Breakdown Structure (WBS) gadget:** ### **1. Add the Work Breakdown Structure (WBS) Gadget to your dashboard** * Make sure you already have Great Gadgets app installed in your Jira instance. If not, you can install it from the Atlassian Marketplace: [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status), [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status), [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status). * Go to your Jira dashboard and click **Add Gadget**. * Search for **Work Breakdown Structure** and click **Add**. ![How to Add Work Breakdown Structure gadget to Jira Dashboard.gif](https://documentation.stonikbyte.com/__attachments/a_393936ab109c2f629d5eed8c6bd9257b023112382dcc94ac5289ab0c6a3ab0a3/How%20to%20Add%20Work%20Breakdown%20Structure%20gadget%20to%20Jira%20Dashboard.gif?cb=84eec9ceb45a30e50f4384ca078add2a) ### **2. Configure the Gadget** * Select a **filter** or enter a **JQL** that returns the work items you want to be displayed * Choose to **expand all levels** * **Switch to Linked Issues View.** For the gadget to display the work items together with their linked items and status, all you have to do is select the **Linked Issues View** option from the **Visualization mode**. ![WBS-Configured-with-Linked-Issues-View.png](https://documentation.stonikbyte.com/__attachments/a_530271ff7e3f0cef6bc28dd047537d3a264bb04c199788fe24a9be9ac95c6b3b/WBS-Configured-with-Linked-Issues-View.png?cb=24311dcded1cb085e1f01fb39df00ed2) 💡**Tip** : Filter by **status category** to show only issues in specific stages such as In Progress, To Do, or Done. ## The Result: A clean, consolidated view of all linked items and their status You get a clean, hierarchical view where dependencies, blockers, and related tasks are visible instantly --- without opening individual issues. ![WBS displaying the status of linked issues .png](https://documentation.stonikbyte.com/__attachments/a_309e89ab62204cbbecb4ce9e3515930a1e139ae1578d4043a9f5a7366c80c0fa/WBS%20displaying%20the%20status%20of%20linked%20issues%20.png?cb=f1851f0411f9059103e6db01b4b0f5a4) No more switching between issue screens. No more guessing dependencies. Everything appears in one structured view. 💡**Tip**: This gadget is also available as a macro in Confluence! ## Why This Matters Having linked issues and statuses visible in one dashboard has a major impact on how teams plan, coordinate and deliver work: * **Faster identification of risks and blockers** - If a story is blocked by a task in another project, you'll see it immediately. * **More accurate planning -**Statuses of linked items directly influence delivery timelines. * **Better cross-team visibility -**Teams can understand how their work impacts others, especially in multi-project environments. * **Improved communication with stakeholders -**Instead of walking them through dozens of tickets, you show one structured view. **Still not convinced?** Our customer say that "*This app brilliantly overcomes Jira's limitations.*" - Atlassian Marketplace review 👉 **If you'd like to test it out, Great Gadgets is free for 30 days on the Atlassian Marketplace.** * [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status) * [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status) * [Great Gadgets for Confluence](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=How_to_Visualize_Linked_Issues_Status) ## **FAQ** **Q: Can Jira show linked issues and their status in a dashboard by default?** No. Jira lets you view linked issues inside an individual issue, but it does not provide any native gadget or dashboard view that lists issues together with their linked issues and their statuses. **Q: Does the Work Breakdown Structure gadget support all link types?** Yes. The Linked Issues View works with any issue link type (e.g., *blocks* , *is blocked by* , *relates to* , *caused by*, etc.). These are taken directly from the issue's linked issues panel. **Q: Can this gadget can display issues by their parent type relationships?** Yes. Besides the Linked Issues View, the WBS gadget can also display issues in an Hierarchy View: Initiatives → Epics → Parent Tasks → Subtasks. **Q: The Work Breakdown Structure is available only for Jira Cloud?** No. The Work Breakdown Structure gadget is also available in **Great Gadgets for Jira Data Center** and **Great Gadgets for Confluence.** ## Related Resources: * [Work Breakdown Structure (WBS) Gadget](https://documentation.stonikbyte.com/great-gadgets/work-breakdown-structure-wbs-gadget.md) * [How to display the progress of Epics, Initiatives and Themes in Jira or Confluence with Great Gadgets](https://blog.stonikbyte.com/2024/11/01/how-to-display-the-progress-of-epics-initiatives-and-themes-in-jira-or-confluence-with-great-gadgets/) * ![youtube_5968852.png](https://documentation.stonikbyte.com/__attachments/a_669f3ffe2c9157a36a756279a960e84fe7685949e325e9b7e37603dda6a3b17f/youtube_5968852.png?cb=642bfb077a5c99b6564f979578900c53) [How to Visualize Linked Issues and Their Status in Jira Dashboards](https://www.youtube.com/watch?v=tNoYdYDV7e0&t=1s) --- language: "en" --- # Issue Filter Formula Gadget ## Overview This gadget calculates and displays the result of a simple formula (like SUM, MAX or AVERAGE) on a numeric field of the work items from a specified Jira work item filter or JQL. The calculated formula result can be displayed as a number, in form of gauge chart or on a 5-star scale. You can use this gadget for calculating and displaying various metrics and project key numbers. For instance, the total remaining work or the work done in your project. ![image-20250630-120353.png](https://documentation.stonikbyte.com/__attachments/a_9d7122f96e1474d6e25a1077e5a583457eecd79b6333afbf2ac593199b21b104/image-20250630-120353.png?cb=43a1e37b1c3319fdc40595c9cb96f48c) Or, you can display the progress toward your team goals by configuring it as a gauge chart with custom limits and colors. ![image-20250630-115937.png](https://documentation.stonikbyte.com/__attachments/a_28df46b93f84ab864138b652dc4d94dcee190ef8c7948a7908524203bcf710db/image-20250630-115937.png?cb=5c519f55a2f688b20c44e4bdee01cc93) In Jira Service Management (JSM), you can use it to make calculations based on the Satisfaction field that is set by customers when completing the satisfaction survey after the ticket closure; for instance, you can calculate and display the average Customer Satisfaction (CSAT) of your support team. ![image-20250630-120207.png](https://documentation.stonikbyte.com/__attachments/a_845474349182c6cd900c0ed0d5368de58da7c3f5c673baf2781f7323917ff295/image-20250630-120207.png?cb=161894ac065d2eabd2f6ab52c91538c4) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings ### Data tab On this tab you can configure the required settings of the gadget. ![Issue filter formula gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_f9b9a9afe5f51f29b70d378c18473a553fac2cab4bd1107b95ac289b760a51c7/Issue%20filter%20formula%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=575fda8b8e4ef835947fc42c0557af0d) | **Setting** | **Description** | |-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **The Meaning of the Data** | Specify the text to be displayed under the calculated value representing the meaning of that value. | | **Data Source** | Select the type of **Data Source** used by the gadget: * A **Saved filter** that contains the Jira work items for which you want to do the calculation. Make sure that the specified filter is shared if you want other people to visualize the dashboard. * A **JQL** query that returns the work items you want to be processed by the gadget. When a filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_3a158487f6398594bb905a21625c3903542b4ce956ef095d96aeac526f2d1fac/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected filter in Jira. | | **Formula** | Choose the basic formula (Sum, Average, Min, Max or Count) to be used in the calculation. | | **Calculation field** | Select the Jira work item field to be used for the calculation. You can choose from a list of the numeric fields available in your Jira instance. * On Jira Server and Data Center, the scripted fields added via the ScriptRunner app are also available for selection here, but only if they are configured as numerical fields in the Custom Fields area of Jira Administration. More exactly, their Search Template must be set to Number Search. * On Jira Service Management, select the Satisfaction field to calculate, for example, the average Customer Satisfaction (CSAT) based on the feedback provided by your customers after their ticket is closed. | | **Math transformation** | Optionally, you can apply an extra math formula to the result of the basic formula. With this extra math formula, you can practically modify the final result with any operation or math function you want. The formula must contain "x", which represents the result of the initial basic formula. A good example is when you use a basic formula against a time field of Jira, like the Original Estimate or Remaining Estimate. Jira stores the values of these fields in seconds and the result of the basic formula will also be in seconds. To transform in hours, you must apply the math transformation "x/3600". | | **Decimal places** | Choose the number of decimals to be used when displaying the final result. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Issue filter formula gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_2662b1c1b3487369dc42d0c94aab59ae242d0f8ad8c507e1151a7275d8211756/Issue%20filter%20formula%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=a8c86db0652fadd99cead8a1081f66e9) | **Setting** | **Description** | |---------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Display mode** | Choose how the result will be displayed: * As **Number** - the default option, which works in all the cases * As **Number colored by value** - choose this option if you want to have a color code associated with the displayed value. In this case, you need to set custom limits and colors. If you check **Extra highlight by coloring border,**the gadget will color the border in the same color. ![image-20251023-104606.png](https://documentation.stonikbyte.com/__attachments/a_12c2d6d28f127e543e211f7e481e2e99095102599081df9ff641cb3e59359252/image-20251023-104606.png?cb=bd1004f4014972df461a159c20c2dc7e) * As **Gauge** chart - choose this option if you want the value to be displayed in a gauge chart. In this case, you need to set custom limits and colors. ![image-20251023-104634.png](https://documentation.stonikbyte.com/__attachments/a_dacce46ec2bffafaccc63b413d74bc8d7967ee3b5289738ba09453de3c9b64ae/image-20251023-104634.png?cb=5bd612748aa3c3d6aef28261a215004f) * On a **5-star rating scale** - if, for example, the gadget was configured to calculate the Customer Satisfaction (CSAT). | | **Display prefix (unit of measure)** | Check this option if you want a text representing the unit of measure to be displayed before the calculated value. A prefix like '$' will be displayed in the form of '$8500.50'. | | **Display suffix (unit of measure)** | Check this option if you want a text representing the unit of measure to be displayed after the calculated value. A suffix like 'h' will be displayed in the form of '168.8h'. | | **Format the number by using commas** | Check this option if you want the calculated value to be displayed with commas. For example, '[15300000](https://bitbucket.org/StonikByte/great-gadgets-add-on/commits/15300000)' will be displayed as '15,300,000' or '5432.1234' will be displayed as '5,432.1234'. | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [How to measure customer satisfaction in Jira or Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/06/27/how-to-measure-customer-satisfaction-in-jira-or-confluence-with-great-gadgets-app/) * [SLA Breaches in Jira: What they are, why they happen and how to track and prevent them using Great Gadgets for Jira](https://blog.stonikbyte.com/2025/06/20/sla-breaches-in-jira-what-they-are-why-they-happen-and-how-to-track-and-prevent-them-using-great-gadgets-for-jira/) --- language: "en" --- # Kanban Velocity Gadget ## Overview This gadget calculates and displays the current average velocity/throughput of the Agile team that is using Kanban based on a Jira filter or an Agile board. The calculation can be done by Story Points, Original Time Estimate, Work Item Count, or any numerical custom field, and it is based on historical data of every work item. You can also choose to include the sub-tasks in the calculation. Use this gadget to see how much business value your team delivers over time and how much work is expected to get done in the next period. ![Kanban velocity throughput gadget.png](https://documentation.stonikbyte.com/__attachments/a_a43a2991a1a4c87c2ad45acd4c664c9305ae5cfd909af1e02eed63133df3e264/Kanban%20velocity%20throughput%20gadget.png?cb=3acd0d53c8ab8e7f0f17cc0e5e1aefca) How does it work? For each time interval displayed in the chart, it counts the work items that were done in that time interval and sums up the estimate that each item had at the end of that time interval. Please note that this gadget does not consider the work items reopened or re-estimated from an interval to another, so the calculated velocity might differ in comparison with the one displayed by the other gadgets, like, for instance, the Release Burnup Burndown Chart gadget. **Done** - The total amount of work done in that time interval, calculated in story points, hours or the number of work items according to the gadget's settings. **Velocity** - The (rolling) average velocity/throughput calculated as the average of done work on the last time intervals, according to the gadget's settings. ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Kanban velocity gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_8dba4d367c3dc7e421a48e28926dab82e7bd260b940d9e1ce4090a0cb08343e0/Kanban%20velocity%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=f4a1101f5b846a90b1701272b6c4351c) | **Setting** | **Description** | |----------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data Source** used by the gadget: * The agile**Board** of your team. * A**Saved filter** representing the scope of your project. Make sure that the specified filter is shared with the users who will also visualize this gadget. * A **JQL** query that returns the work items you want to be processed by the gadget. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_44693caa5a17fe09a089a8ff0f8ec4506a3ce08abf00fa59e7db5d383f48a57f/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Count also the sub-tasks and their estimate** | Check this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation. | | **Calculate by** | Specify on which criteria the calculation is to be performed. You can choose between: * **Story Points** - the default value; use this if the work items are estimated in Story Points. If the work items are from team-managed spaces, select **Story Point Estimate** instead. * **Original Time Estimate** - use this if you use time estimates; the calculation will be done in hours. * **Work Item Count** - use this if you want the calculation to be done by number of work items. * Other **numerical custom field** defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the work items. | | **Intervals of** | Specify the duration for the time intervals used when calculating and displaying the velocity. If you do Agile development, this should be set according to the length of your sprints or iterations. | | **Time range** | Select the time intervals to be displayed by the gadget. You can choose between: * **Most recent intervals** -- Select this option if you want the gadget to display velocity/throughput for the most recent past intervals. In this case, you must provide an **Alignment date**, which is used to align the time intervals shown in the chart (for example, if you want intervals to start on a Monday, choose a Monday date). Optionally, you can select **Include the current (incomplete) interval** to display the interval for the current day. Keep in mind that this interval is incomplete, so the calculated velocity will be impacted accordingly. * **Past intervals from a specific date** -- Select this option if you want the gadget to display velocity/throughput starting from a specific past **Start date**. | | **Intervals to display** | Specify the number of previous completed time intervals to be displayed in the chart. | | **Calculate average velocity based on last ? intervals** | Specify the number of time intervals to be used when calculating the average velocity. Velocity is calculated as the average of the total SPs done in each of these intervals. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Kanban velocity gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_f48dea14ce7708a8dd3a3f244b28eabdbdd2263e26f0a9acd7d02db75ef05e52/Kanban%20velocity%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=33c15a6026d565fd1e803641ce80a3e5) | **Setting** | **Description** | |-----------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **"Done" means** | Specify how the gadget should consider work items as done when determining the work completed. The default option is **Work item status has the category done**, which means that the work item is considered done if it has reached a "done" category status (such as Resolved, Closed, Done or any other green-colored status of Jira). Choose **Work item is in last column of the selected board** and select an agile board if you want to consider work items as done when they reach the last column of the board or, more exactly, a status that is mapped to the last board column. Choose**Work item is in one of these statuses,** and then select one or more workflow statuses, to consider work items as done when they reach one of these custom statuses. Choose **Work item reached one of these statuses**, and then select one or more workflow statuses, to consider as "Done" those work items that reached one of the specified statuses at least once. | | **Show legend** | Check this if you want the chart legend to be displayed. | | **Tilted labels for x-axis** | Check this option to avoid overlapping labels on the x-axis. | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Show data tab** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays all the time intervals with the work items that affected their velocity. The work items that had zeros on all the columns are not displayed. ![Kanban-velocity-gadget---data-table.png](https://documentation.stonikbyte.com/__attachments/a_5b81ed75909622e18bcff93dd7d4d1c982fd0612c6234e89b40039d3c698dd06/Kanban-velocity-gadget---data-table.png?cb=c1b5758646d21462e8a79592246fab1b) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | | **Show backlog forecast** | Check this option if you want the gadget to display a tab with the current backlog (unresolved work items from the selected board) displayed along with their ETA determined automatically based on the current velocity. Before checking this option, ensure that your backlog is properly ranked, with the most urgent work items at the top of the list. ![Kanban-velocity-gadget-backlog-ETA.png](https://documentation.stonikbyte.com/__attachments/a_2e367661172893017ba27421d5c7f64cf327e87e0d19011d9796f491d0ebc7e9/Kanban-velocity-gadget-backlog-ETA.png?cb=1de0fb5c4bccae62584a418e3a9db2c8) This setting applies only if the gadget has **Data Source** of type *Board*. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent. | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Kanban velocity gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_00bc726a550b2b65004405ecd565a9c165ce5121b270d14936cfdb6807d7e215/Kanban%20velocity%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=63f8f100e4587a0aa41203bf7d6167e2) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [How to track the team velocity / throughput in Kanban with Great Gadgets app for Jira](https://blog.stonikbyte.com/2019/11/26/how-to-track-the-team-velocity-in-kanban-with-great-gadgets-app-for-jira/) * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) --- language: "en" --- # Manual Migration from Server / Data Center to Cloud This page describes the **manual procedure** for migrating Great Gadgets from Jira Server / Data Center to Jira Cloud. If you are migrating from **Jira Data Center to Jira Cloud using the Jira Cloud Migration Assistant (JCMA)** , we recommend using our [**automated migration procedure**](https://documentation.stonikbyte.com/great-gadgets/migration-from-data-center-to-cloud-via-jcma.md) instead. With the automated procedure, Great Gadgets gadgets and their configurations are migrated automatically as part of the JCMA migration, significantly reducing the need for manual reconfiguration. If you are not using JCMA, or if you only have a small number of dashboards and gadgets to migrate, you can use the manual procedure described on this page. With the manual procedure, the Great Gadgets gadgets and their configurations are **not migrated automatically**. After migrating your Jira data to Cloud, you will need to manually add and configure the Great Gadgets gadgets on the migrated dashboards to match their configuration in the original Server / Data Center instance. Great Gadgets for Jira Cloud offers the same gadgets and functionality available in the Server / Data Center version, allowing your existing dashboards to be recreated in Jira Cloud. See also [Feature parity between Server, Data Center and Cloud](https://documentation.stonikbyte.com/great-gadgets/feature-parity-between-server-data-center-and-cloud.md). If you have additional questions or need assistance with the app migration, please contact StonikByte Support at [support@stonikbyte.com](mailto:support@stonikbyte.com). ## Migration of app gadgets from Jira dashboards To determine the **gadgets usage** in your Jira Server / Data Center instance, you can run this SQL query on the Jira database: SQL SELECT portletconfiguration.gadget_xml, portalpage.pagename, portalpage.id, portalpage.username FROM portletconfiguration INNER JOIN portalpage ON portletconfiguration.portalpage = portalpage.id WHERE portletconfiguration.gadget_xml LIKE '%com.stonikbyte.great.gadgets%' This returns a list with the gadget identifier (gadget_xml), the name (pagename) and the identifier (id) of the dashboard where the gadget is located, and the user who added the gadget to the dashboard (username). ![image-20240618-082429.png](https://documentation.stonikbyte.com/__attachments/a_a0eaa89c49d00ddc70fdb3780a2d66cc925291bd7bf9a22fe6a8901f85cfe044/image-20240618-082429.png?cb=ff678e170270b2fb2b0bf60bb18dbb2f) Our **recommended approach** is as follows: 1. Migrate your Jira data first using the appropriate migration tools provided by Atlassian. During this process, your Jira dashboards may be migrated; however, the app gadgets will not be included. 2. Install [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview) in the new Jira Cloud instance. 3. If your new Jira Cloud instance uses IP allowlists, add the Great Gadgets IPs to the allowlist. See [Technical Notes \| IP Allowlisting](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md#IP-Allowlisting). 4. Optionally, enable and configure [Data Residency](https://documentation.stonikbyte.com/great-gadgets/data-residency.md). 5. Run the SQL script above on the old Jira Data Center database to identify which gadgets were used, in which dashboards, and who the dashboard owners are. 6. Send the list of dashboards to each respective owner (via e-mail) and ask them to review and reconfigure their dashboards by manually re-adding and configuring the gadgets in the new Jira instance, matching their previous setup in Jira Data Center. This approach distributes the effort across multiple users and may also lead to cleanup, as some dashboards or gadgets may no longer be needed. ## Migration of app gadgets used as macros in Confluence pages If you had the app gadgets imported as macros in Confluence Data Center, you will not be able to do the same on Cloud because Confluence Cloud does not support importing gadgets from Jira Cloud apps. You can preserve the functionality of the macros added to Confluence pages by installing [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview) and then manually re-configuring the macros from the Confluence pages. The app macros that rely on data from Jira cannot connect to the old Data Center instance, so make sure to migrate Jira first in order to preserve macro functionality in Confluence. On Jira Cloud, apps have their own "app account", which is not visible in User Management. Some app gadgets may not display data if the filters configured for them are not accessible to the app account. To resolve this issue, ensure that the filters used in the gadget configuration are shared (Viewer permissions) with either a Jira *space* (recommended) or with *My organization*. This can be done by editing the filter's details. ![image-20260513-051654.png](https://documentation.stonikbyte.com/__attachments/a_6d08550a73e74468767f9e594efcf8cb2455b0aa7f10a7d927217f925060fee7/image-20260513-051654.png?cb=3b0475d31645f36968bc9f220d37f41d) --- language: "en" --- # Migration from Cloud to Cloud Migration of Jira and/or Confluence data from a Cloud instance to another Cloud instance is usually done by using data copying process recommended by Atlassian (see ). Please consider the following when planning a Cloud to Cloud migration of a Jira and/or Confluence instance that has the Great Gadgets app installed. ## **Migration of app data during a Jira Cloud-to-Cloud migration** Great Gadgets for Jira Cloud mainly consists of gadgets that are added to Jira dashboards. Currently, Atlassian's migration tools support dashboard migration between Jira Cloud instances; however, ++gadgets provided by third-party apps are not migrated++ as part of this process. As a result, migrating Jira dashboards along with the app gadgets must be done ++manually++. To complete the migration: * Migrate your Jira Cloud data (projects, filters, boards, fields, statuses, etc.) to the new Jira Cloud instance using Atlassian's tools. For more details, see: * After the data migration is complete, install [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview) in the new Jira Cloud instance. * If Data Residency was enabled in the old Jira Cloud instance, configure the same settings in the new instance. See: [Data Residency](https://documentation.stonikbyte.com/great-gadgets/data-residency.md). * If you use IP allowlists in the new Jira Cloud instance, make sure to allow the IP addresses required by the app in the new instance. See [Technical Notes \| IP Allowlisting](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md#IP-Allowlisting). * Since Atlassian tool migrates dashboards without app gadgets, you need to manually add the app gadgets to the migrated Jira dashboards and configure them to match the setup in the original Jira Cloud instance. ### **Migration of app data during a Confluence Cloud-to-Cloud migration** [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview) consists only of macros that are added to Confluence pages. The app has no global or user-specific settings, so the only data that needs to be migrated is the macros added to Confluence pages along with their configuration settings. When you migrate Confluence spaces from one Confluence Cloud instance to another Cloud instance, the app macros embedded in pages (and their configuration settings) are automatically migrated. Once the spaces are migrated to the new Confluence instance, you will also need to install [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview) in the new Confluence instance. See [Using the gadgets in Confluence Cloud](https://documentation.stonikbyte.com/great-gadgets/how-to-use-great-gadgets.md#Using-the-gadgets-in-Confluence-Cloud). Most of the app macros use data from the Jira Cloud instance linked to the Confluence Cloud instance, so they will not be functional at this stage. To restore the functionality of the macros, please do the following: * Migrate your Jira Cloud data (projects, filters, boards, fields, states, etc.) to the Jira Cloud instance that is connected to the new Confluence Cloud instance, if it has not already been migrated. This can be done by using the tools provided by Atlassian, see . * After you migrated your Jira Cloud data to the new Jira Cloud instance, the migrated objects (projects, filters, boards, etc.) have different IDs in the new instance and therefore will not match the IDs in the migrated macro configuration, so they will need to be ++manually reconfigured++ to point to the migrated Jira objects (projects, filters, fields, states, etc.). Our advice is to ask the space and page owners to check and reconfigure the macros one by one. * To determine the usage of each macro, go to **Confluence administration** \> **Data management** \> **Macro usage**. The app gadgets are the ones having "comStonikbyteGreatGadgetsConfluencePlugin" in their name. Clicking link of a used macro, will show the Confluence pages that use that macro. ![image-20250324-120555.png](https://documentation.stonikbyte.com/__attachments/a_95b0601322260ca7200fd72b987652067510149fa367d6ace2000715cc951c63/image-20250324-120555.png?cb=e59cc4bcdee2e6d98aafbb9f681b5167) --- language: "en" --- # Migration from Data Center to Cloud via JCMA Great Gadgets supports **automated migration from Jira Data Center to Jira Cloud** through the **Jira Cloud Migration Assistant (JCMA)**. During the migration, Great Gadgets dashboard gadgets and their configurations are automatically migrated to their Cloud equivalents, helping preserve your existing dashboards and minimize manual reconfiguration. This automated procedure is recommended when you have many dashboards to migrate and are migrating your Jira data using Jira Cloud Migration Assistant (JCMA). Note: If you are not using JCMA or have only a few gadgets to migrate, consider using the manual migration procedure described at [Manual Migration from Server / Data Center to Cloud](https://documentation.stonikbyte.com/great-gadgets/manual-migration-from-server-data-center-to-cloud.md). ## STEP 1: Install the required apps Make sure the following apps are installed and updated to their **latest versions**. On **Jira Data Center**: * [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview) * [Jira Cloud Migration Assistant (JCMA)](https://marketplace.atlassian.com/apps/1222010/jira-cloud-migration-assistant) On **Jira Cloud**: * [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-agile-dashboard-charts-metrics-kpi-reports?hosting=cloud&tab=overview). * Make sure you configured [Data Residency](https://documentation.stonikbyte.com/great-gadgets/data-residency.md) after installing this app. * [Great Gadgets Migration Assistant](https://developer.atlassian.com/console/install/db20e858-1957-4ca7-b820-0b9d0ff75235?signature=AYABeHgwOERGgNzDgenDv75NdZUAAAADAAdhd3Mta21zAEthcm46YXdzOmttczp1cy13ZXN0LTI6NzA5NTg3ODM1MjQzOmtleS83MDVlZDY3MC1mNTdjLTQxYjUtOWY5Yi1lM2YyZGNjMTQ2ZTcAuAECAQB4IOp8r3eKNYw8z2v%2FEq3%2FfvrZguoGsXpNSaDveR%2FF%2Fo0B6LX424kwuoNGMxCjlEbnMgAAAH4wfAYJKoZIhvcNAQcGoG8wbQIBADBoBgkqhkiG9w0BBwEwHgYJYIZIAWUDBAEuMBEEDEyBQ%2BI7n9niWaTYmgIBEIA7yctVjwywmTy8dtCTIvN7JF%2FQlogwoxUdpS8h0KxG74aO1DxqTmbvW5Gx%2BgEtL9JtdYyv0kje1z04rgcAB2F3cy1rbXMAS2Fybjphd3M6a21zOmV1LXdlc3QtMTo3MDk1ODc4MzUyNDM6a2V5LzQ2MzBjZTZiLTAwYzMtNGRlMi04NzdiLTYyN2UyMDYwZTVjYwC4AQICAHijmwVTMt6Oj3F%2B0%2B0cVrojrS8yZ9ktpdfDxqPMSIkvHAHyD8O6eUCs6ZKaoyOUDZ5rAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQM%2B3p3M0Bg2UvvKcFIAgEQgDsbIxyc0ghCgYoRYeSIKjKqakwEbbULiwQCMnefahwrHkMp3qjydaVfut%2F22C9miTwymnkTRcrXNqjxVwAHYXdzLWttcwBLYXJuOmF3czprbXM6dXMtZWFzdC0xOjcwOTU4NzgzNTI0MzprZXkvNmMxMjBiYTAtNGNkNS00OTg1LWI4MmUtNDBhMDQ5NTJjYzU3ALgBAgIAeLKa7Dfn9BgbXaQmJGrkKztjV4vrreTkqr7wGwhqIYs5AfkORWEHCZD2kEDGfC0Ao70AAAB%2BMHwGCSqGSIb3DQEHBqBvMG0CAQAwaAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAz%2F0q9WiexMZZ6iKkgCARCAO%2FFIA1Z%2BCFWUprFxD4FM352Mlki2NjTmrTKh%2FxBO66yEboXz7pLHZljpqA5LJMjjUP6kLMfFrHzA2YeZAgAAAAAMAAAQAAAAAAAAAAAAAAAAAD14uYfYTzH29X5QTqXfng3%2F%2F%2F%2F%2FAAAAAQAAAAAAAAAAAAAAAQAAADLqYjpRmU%2FWCYh1ZuQYWh391HzkvI9CbvYZsB6BdmHVf9XqyWU4vVtGtodW8atUP5zYIvVvM31P62IhONuYAw0jtC4%3D&product=jira) **Great Gadgets Migration Assistant** is required only for the actual migration. It is **not required**when running the migration assessment. Once the migration is complete, the app can be safely uninstalled. The **Great Gadgets Migration Assistant** is an Atlassian Forge app with the **Runs on Atlassian** badge. This means that it runs entirely on Atlassian Cloud infrastructure and does not egress data outside of Atlassian Cloud. The app is installed via a distribution link and is not listed on the Atlassian Marketplace. ## STEP 2: Run the migration assessment on Jira Data Center and prepare the data Before starting the migration, run a migration assessment to identify the Great Gadgets dashboard gadgets that need to be migrated and detect any potential issues. The assessment provides a report that should be reviewed before proceeding with the migration. Any reported problems should be addressed on the **Jira Data Center** instance whenever possible. To run the assessment: * Go to **Jira Administration → System -\> Import and export → Migrate to cloud**. * Create a new migration and follow the on-screen instructions. * When prompted to select what should be migrated, make sure the following items are included: * **All dashboards** * **All filters and cross-project boards** * **All apps marked as "Needed in cloud" that have an available migration path** ![image-20260823-082117.png](https://documentation.stonikbyte.com/__attachments/a_b2b10a0ef2c1501772022c293f9e27b83ecfe6914b3d04c93d6e6608059f07ab/image-20260823-082117.png?cb=89eba33c7014ebe5d0ac8423e6e295ee) * Click **Save and run pre-migration checks** and wait for the checks to complete. * Scroll down to the **Apps** section and review the app check results. ![image-20260823-083127.png](https://documentation.stonikbyte.com/__attachments/a_efefc6e46f59c46091cb539c8c3512f7fe4bdfbb9fd92d7e99e0575855a09896/image-20260823-083127.png?cb=2cc0b22d8bea36f3e149ee1be6f7db4b) * If **Great Gadgets** is listed under **"Apps with unknown or low migration success rate"**, you can safely ignore this message. This is expected because the migration path for Great Gadgets was only recently introduced. * Click **View app vendor checks** to review the migration checks specific to **Great Gadgets**. ![image-20260826-064354.png](https://documentation.stonikbyte.com/__attachments/a_13156e1b5b3bb647e955381fa893115433f8fe2699d0f169e973a85a7bf7e2f7/image-20260826-064354.png?cb=27213256ff5e5b9d74ee8c2f728643d6) * The **Dashboard Permissions** warning asks you to check whether the Jira dashboards containing app gadgets grant the necessary edit permissions to all roles of a Jira project. These permissions are required for the app to migrate the gadgets. * Click **Download report**. This downloads a CSV file containing a list of Jira dashboards with app gadgets that are missing the required edit permissions. * Open the downloaded CSV file in**Microsoft Excel**or another application that supports CSV files and review the results. ![image-20260826-083219.png](https://documentation.stonikbyte.com/__attachments/a_6af687d68e23f9a679ab946bc85a795584294ff0c444cde545709931c5c8fbff/image-20260826-083219.png?cb=f94daa6529ca10d83c443959a56d7052) **WARNING:** The downloaded report may be truncated because JCMA limits these reports to 250 KB. Check the last line of the downloaded report: * If it displays **"Completed"**, the report is complete and can be used as is. * If **"Completed"** is missing, check the first line of the report for the file path and retrieve the complete report from that location under the Jira home directory. ![image-20260916-150106.png](https://documentation.stonikbyte.com/__attachments/a_5d860d664f0d5977ecf7fb984aa71abe39b93662c8c194761f268e207fdec0b4/image-20260916-150106.png?cb=fba27d4a45e9d141c42bf92f037de8e0) You can fix the dashboard permissions either automatically (recommended) or manually. * * To fix **automatically (recommended)**: * Create a temporary project in Jira Data Center. Name it "*Temp Project for Great Gadgets Migration*". This will be used only for migration, so you can safely remove it after migration is finished. * In Jira Data Center, go to **Jira Administration \> Manage Apps \> Great Gadgets Migration**. ![image-20260827-075510.png](https://documentation.stonikbyte.com/__attachments/a_4d4dfc535e0fabdf4a6a2d833314b23d2c8dc12a7dfe61276e3009751da315e3/image-20260827-075510.png?cb=a60594475f497802808b907471bb9740) * * * Under **Project** select the newly created temporary project "*Temp Project for Great Gadgets Migration*" * Click the **Fix Dashboard Permissions** button. The app will grant edit permission to all roles of the selected project for all dashboards containing app gadgets, if not already granted. ![image-20260827-075615.png](https://documentation.stonikbyte.com/__attachments/a_20568b0fc7797a7eae8b887f4ac959ab0ef7b2f1b9376726c5b3449b1e096583/image-20260827-075615.png?cb=361dd754b064f30f8f3401f15c2f75dc) * * To fix **manually**: * For every dashboard listed in the report grant edit permission to all roles of any Jira project ![image-20260827-071759.png](https://documentation.stonikbyte.com/__attachments/a_ff259e6ec3c5562f928c0f859a7293d513b9d5cc264057091f826c8f89d31d73/image-20260827-071759.png?cb=467b0ec7c0e7707cdd13012cb033d570) * * Address the other warnings, then rerun the assessment by clicking **Refresh All** to confirm that the required dashboard permissions have been granted and that the new report contains no dashboards with missing permissions. * The **Requirements** warning indicates that the **Great Gadgets Migration Assistant** app must be installed on your **Jira Cloud** instance for the migration to work. Make sure the app is installed before starting the actual migration. See **STEP 1: Install the required apps** above. * For addressing the **Filter Sharing \& Gadget Configuration Checks** warning: * Click **Download report**. This downloads a CSV file containing details about the Great Gadgets gadgets to be migrated, along with any issues or corrections that should be addressed before starting the migration. * Open the downloaded CSV file in**Microsoft Excel**or another application that supports CSV files and review the results. ![image-20260823-120228.png](https://documentation.stonikbyte.com/__attachments/a_6dfcbb50401526ffcef7e1f57cd65ab0751ae72cdf6aad1eef3e950d537b4a92/image-20260823-120228.png?cb=54c1cd40e8f2bcef547cd02b265d1ef9) * * Review and correct the following types of entries in the report: * Check the entries where the **Permission Warning** column contains an **X** . This indicates that a filter used directly as a gadget data source, or associated with an Agile board used as a gadget data source, is not properly shared. As a result, Great Gadgets might not be able to access the filter in Jira Cloud after migration, causing the gadget to display an error. To fix this, open the corresponding filter in **Jira Data Center** and update its **View permissions** to share it with a **Project (all roles)** or with **Any logged-in user**. ![image-20260823-092021.png](https://documentation.stonikbyte.com/__attachments/a_17d7bdefaf4fd41d10fb6d65097e061f35b21b227a51f0a7ae28fb5d4a8e4918/image-20260823-092021.png?cb=ad4bd254f9aabfdfd1371bb8c3ae4e69) * * * Check the entries where **Status** is **WARNING** and the **Message** is **Not configured**. These represent app gadgets that were added to dashboards but were never configured. We recommend deleting these gadgets from the Jira Data Center dashboards before starting the migration. If you leave them in place, they will not be migrated. * Review the **JQL** column, which contains the JQL of the filters or board filters used by the gadgets. Pay particular attention to queries that use **custom JQL functions**, such as functions provided by other apps (for example, ScriptRunner). Some of these functions might not have an equivalent in Jira Cloud. In such cases, the affected gadgets might not work as expected after migration and will need to be manually reconfigured. * After correcting the identified issues in **Jira Data Center**, create a new migration in JCMA and repeat the assessment steps above, download a new report, and confirm that the relevant warnings have been resolved. * **IMPORTANT** : If you created the temporary project "*Temp Project for Great Gadgets Migration*" at the previous steps, make sure to include it in the new migration. * Once the migration assessment is complete and the identified issues have been addressed, you can proceed to the next step of the migration. ## STEP 3: Run the migration * You can now trigger the migration in JCMA by clicking the **Run** button of your current migration * Great Gadgets will appear in the migration under the **App migration process** section and its migration will start after JCMA migrates the other Jira data. ![image-20260826-102558.png](https://documentation.stonikbyte.com/__attachments/a_5fd1400c967576926c378b9942cd081bd30687498b078cd9f7e8d58c5d407849/image-20260826-102558.png?cb=3ae60363f08ea2447495895c7bbeec3e) * Once the migration is finished you can download the log file showing all the actions performed along with any errors and warnings ![image-20260826-102816.png](https://documentation.stonikbyte.com/__attachments/a_0a04b40d96b009bc0bb59ae2b302d2f68c969cfd70c0ce7a5df55e5a11b4e9d9/image-20260826-102816.png?cb=342f1e5c845e6fbbc85d8e58343f9468) ## STEP 4: Perform post-migration steps * If you migrated Great Gadgets along with your Jira data, Jira might still be re-indexing the migrated data and display a message like this at the top of the page. We recommend waiting before verifying the migrated gadgets, as Jira filters might return incomplete results during this process, causing the gadgets to display incomplete or incorrect data. ![image-20260827-145737.png](https://documentation.stonikbyte.com/__attachments/a_c394c7d50ba5695c16a9ff07f24d3b3938567b190ef085afb655a0723df3d2ad/image-20260827-145737.png?cb=04d2a38624df3c8f9d4ae1e46b7fa761) * Once Jira has finished re-indexing the migrated data, you can start verifying the migrated dashboards. If you resolved all the warnings identified during the migration assessment, all app gadgets are expected to have been migrated with their existing configurations preserved, requiring no manual rework. * If a gadget displays incorrect data, it might be due to cached data generated before Jira finished re-indexing the migrated data. In this case, try enabling the **Refresh cached data at next display** option (if available) from the **More settings** tab of the gadget configuration. * You can re-run the migration if needed. In this case the gadgets that have already been migrated will **not be duplicated**; their configurations will simply be updated. * It is now safe to delete the temporary project **"Temp Project for Great Gadgets Migration"** from Jira Cloud if it was created to fix dashboard permissions. **DO NOT DELETE this project from Jira Data Center**, as doing so might prevent the dashboards from being edited further. ## **Known Limitations** * We preserve **the order of the app gadgets** as they were in Jira Data Center. However, if a dashboard also contains Jira native gadgets or gadgets from other apps, we cannot guarantee that the overall gadget order will be preserved. In this case, the gadgets may need to be rearranged manually after migration. * If you have **app gadgets imported as macros** into Confluence Data Center and added to Confluence pages, they will not be migrated automatically through this process. See [Migration of app gadgets used as macros in Confluence pages](https://documentation.stonikbyte.com/great-gadgets/manual-migration-from-server-data-center-to-cloud.md#Migration-of-app-gadgets-used-as-macros-in-Confluence-pages) for instructions on how to migrate them. For any questions or assistance with the migration, feel free to contact **StonikByte Support** by raising a ticket through our [Support Portal](https://stonikbyte-production.atlassian.net/servicedesk/customer/portal/1) or by emailing us at [support@stonikbyte.com](mailto:support@stonikbyte.com). --- language: "en" --- # Migration from Server to Data Center If you migrate your Jira instance from Server to Data Center by preserving the existing Jira data, there are no special steps to follow in order to migrate Great Gadgets app. After applying the new Data Center specific license key, the app will continue to work as before. If you migrate to Data Center without preserving the existing Jira data, this will be like a new app installation. You will have to create new Jira dashboards and configure the app gadgets from scratch. --- language: "en" --- # Migration Steps Please select the appropriate migration path below based on the type of migration you need to perform. ## From Jira Data Center to Jira Cloud When migrating Great Gadgets from **Jira Data Center to Jira Cloud**, you can choose between two migration methods: *** ** * ** *** ### 🪄 Automated migration with JCMA (Recommended) See [Automated migration from Jira Data Center to Jira Cloud](https://documentation.stonikbyte.com/great-gadgets/migration-from-data-center-to-cloud-via-jcma.md). This is the **recommended migration method** if you are using the **Jira Cloud Migration Assistant (JCMA)** to migrate your Jira data. Great Gadgets gadgets and their configurations are migrated automatically as part of the JCMA migration process, significantly reducing the need for manual reconfiguration. **Recommended when:** * You are using JCMA to migrate your Jira data. * You have many dashboards and gadgets to migrate. * You want to minimize manual reconfiguration. *** ** * ** *** ### 🛠️ Manual migration See [Manual migration from Jira Data Center to Jira Cloud](https://documentation.stonikbyte.com/great-gadgets/manual-migration-from-server-data-center-to-cloud.md). This method does not use automated migration tools. The Great Gadgets gadgets and their configurations must be manually recreated in Jira Cloud. **Recommended when:** * You are not using JCMA. * You only have a small number of dashboards and gadgets to migrate. *** ** * ** *** ## Other migration types For other migration scenarios, see: * [Jira Cloud to Jira Cloud migration](https://documentation.stonikbyte.com/great-gadgets/migration-from-cloud-to-cloud.md) * [Jira Data Center to Jira Data Center migration](https://documentation.stonikbyte.com/great-gadgets/migration-from-server-to-data-center.md) ## See also * [Feature parity between Server, Data Center and Cloud](https://documentation.stonikbyte.com/great-gadgets/feature-parity-between-server-data-center-and-cloud.md) --- language: "en" --- # Pivot Table & Pivot Chart Gadget ## Overview The **Pivot Table and Pivot Chart** gadget allows you to create and display pivot tables or pivot charts based on items in your projects using an intuitive drag-and-drop interface, similar to tools like Excel. A **pivot table** is a data-summarization tool that helps you organize, group, and analyze data in a clear and manageable way. It transforms large datasets into concise, actionable reports by performing operations such as summing, averaging, or counting values based on selected fields. With this gadget, you can build multi-dimensional tables directly on your dashboards, making complex project data easier to understand and analyze. It can calculate not only the count of work items, but also sum of numerical fields and percentages. A **pivot chart** is a visual representation of the data in a pivot table. It helps you quickly identify patterns, trends, and comparisons by presenting summarized data graphically. The gadget supports the configuration of multi-dimensional pivot tables, including simple tables and heat maps, as shown in the examples below. ![Pivot Table - Work-items-by-assignee-over-years.png](https://documentation.stonikbyte.com/__attachments/a_57cddf2adf78ec6549e3b842a0ccf18f3e113930d559e491ef67517a5c1380e8/Pivot%20Table%20-%20Work-items-by-assignee-over-years.png?cb=6f105b1fc240f53f246e15d40d6b41e5) ![Heatmap pivot table - work items by type.png](https://documentation.stonikbyte.com/__attachments/a_d4e0312d53fbadd68c531df277fdb94a5ff02ffd63021a528e12660b98696889/Heatmap%20pivot%20table%20-%20work%20items%20by%20type.png?cb=1aac3aad82d01bd719e0af313106b833) The gadget allows you to choose from various types of pivot charts: column charts, line charts, bar charts, stack area charts or pie charts. ![Pivot-Charts.png](https://documentation.stonikbyte.com/__attachments/a_5a13b76b32e11794d4a0054276e74fa956e0370ccab2cc0a463cfe1d56c3bf52/Pivot-Charts.png?cb=073479f22acc7081b0fece34c4161494) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors tab** - lets you choose the base color of the heatmap table ![New-Heatmap--Blue---GIF.gif](https://documentation.stonikbyte.com/__attachments/a_241d6a47dfdcad6e171509b00b0150d188e176b93b3d8c6a3684d15b9e3e20b1/New-Heatmap--Blue---GIF.gif?cb=f38324c546b27dd0ac774e2d667c045f) Follow the steps below to configure the gadget as Pivot Table or Pivot Chart: ![Pivot---Data-tab.png](https://documentation.stonikbyte.com/__attachments/a_23199525bdf7e98e9e1bf709f0f2a7408aa051789de9eabc3eebda70a380ac16/Pivot---Data-tab.png?cb=63e19e5eddd1d5bcbb874d2e43e024f3) * Add the *Pivot Table \& Pivot Chart* gadget to your Jira dashboard. * Enter a suggestive **Gadget title**. * At **Data Source** , select the *Filter* or enter a *JQL* that returns the work items that serve as input data for the pivot table or pivot chart. If you want the sub-tasks from the selected filter or JQL to be included, check **Include sub-tasks**. * At **Fields** ,select the work item fields that you need in your pivot table or pivot chart. * The table from the **Output configuration** section allows you to configure the pivot table or pivot chart. * In the top-right cell, select the type of the output data: pivot table or pivot chart. ![Pivot---output-configuration.png](https://documentation.stonikbyte.com/__attachments/a_52bd12637390fb9edd4c5da5929921cbe1c92bb5a16862ef8f2aa29f8acd414c/Pivot---output-configuration.png?cb=34c4540c8ff8f00e6765bf504acae04e) * If you want to display the results as a regular **pivot table** , select *Table* . Or, select *Table Heatmap* to display the results as a heatmap-capable table where the values of interest are highlighted in shades of red. * If you want to display as a **pivot chart**, select the appropriate option for the type of chart you want. * By using drag \& drop, place the work item fields that you want to be displayed on the **columns** and the **rows** of the table. ![Pivot---output-configuration2.png](https://documentation.stonikbyte.com/__attachments/a_8be44b6816bc581c0a743143d71b462650b06d76201a9e8d663f2798774c821b/Pivot---output-configuration2.png?cb=a6f755b3e98ffefe10077800a27c54d0) * Choose the calculation criteria. You can choose between various options. For example, to display the number of work items in table, select *Count*. ![Pivot---output-configuration3.png](https://documentation.stonikbyte.com/__attachments/a_25e7f86b05c8a2d75074179efd330f43354dafd26b66e6e03b46da2fd61fbe8b/Pivot---output-configuration3.png?cb=306f0421464a3bae6fa76af66a68ead0) * If you want to display the sum of an work item field (like Story Points), select *Sum* and then the select field; make sure the field that you want to sum-up was added to the **Fields** option above. * A preview of the gadget results is displayed based on the configuration you made and using some randomly generated ++dummy data++. ![Pivot---output-configuration4.png](https://documentation.stonikbyte.com/__attachments/a_e1b32f1849e0b395a38e92f02c17d51a3b578833f29ba969f4e98252cb0c6a9a/Pivot---output-configuration4.png?cb=01a60ec4f6581cf239df65f19511af37) * On the **More Settings** tab, you can choose the display format for the fields that you selected for being used in the Pivot Table or Pivot Chart. For example, for date fields like Created or Updated you can choose a format like "MM/dd/yyyy" or "yyyy", while for time fields like Time Spent or Original Estimate you may choose to display the result in "Hours" or "Calendar Days (24h)". * Make any adjustments as necessary and when you are done, click **Save**. The gadget will now display the pivot table or pivot chart that you configured by using real Jira data. ### Data tab On this tab you can configure the required settings of the gadget. | **Setting** | **Description** | |---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data Source** | Select the type of **Data Source** used by the gadget: * A **Saved filter** containing the work items that you want to track. Make sure that the specified filter is shared with the users who will also visualize this gadget. * A **JQL** query that returns the work items you want to be processed by the gadget. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** -Select one or more work items above the Epic level, such as Initiatives or Themes. When a filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_81c274a9e95143361acfac41fc9ff94bc1411b9fee9145b3e777e63295009266/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected filter in Jira. | | **Include the sub-tasks** | Check this option if you want the sub-tasks from the selected filter or JQL to be included in the calculation. | | **Fields** | Select the work item fields you need to generate the pivot table or pivot chart. The multi-value fields such as **Labels** , **Fix Version/s** or **Components** are marked with the symbol `[≣]`. Only one field of this type can be selected at a time. If the **Sprint** field is selected, only the most recent sprint is considered for work items that have gone through multiple sprints. The **Parent Epic** (on Cloud only) and **Epic Link** fields can be used to display the parent epics. The epics are displayed in form of *key: summary* (for example, *DEMO-1: My epic summary* ). See more examples in section [Epics Progress](https://stonikbyte-production.atlassian.net/wiki/spaces/GG/pages/edit-v2/112066564#Epics-Progress). Also, on Cloud you can display statistics at the initiative or theme level if you have these additional hierarchy levels added on top of epics. For this, use **Parent of Epic** (for work items with hierarchy level 2 work items) or **Parent L3** (for work items with hierarchy level 3). See more examples in section [Progress of the Initiatives or Themes](https://stonikbyte-production.atlassian.net/wiki/spaces/GG/pages/edit-v2/112066564#Progress-of-the-Initiatives-or-Themes). You can also select field specific to Jira Service Management projects such as **Satisfaction** or **Sentiment**. If you enabled [approvals](https://support.atlassian.com/jira-service-management-cloud/docs/what-are-approvals/) in your Jira Service Management instance, you can generate statistics based on these fields: * **Approval Status** - indicates the overall approval status of the work item * **Approvers** - lists the users that are set (directly, not via an approver group) as approvers to the work item * **Approver Groups** - lists the approver groups of the work item * **Approvers - Approved** - lists the approvers who approved the work item * **Approvers - Declined** - lists the approvers who declined (rejected) the work item through the approval flow * **Approvers - Pending** - lists approvers who have not yet approved or rejected the work item | | **Output configuration** | This is the place where you can configure the pivot table or pivot chart. ![Pivot table - documentation-20240403-114331.png](https://documentation.stonikbyte.com/__attachments/a_755820eb1f21d56996ddb79e101a23f4a8c565a7a2b909c29e0496d90c26747a/Pivot%20table%20-%20documentation-20240403-114331.png?cb=5b34a6c11ab091aae4925ee622f87098) ![1.png](https://documentation.stonikbyte.com/__attachments/a_87d0190bb0d451d0961112998fe3fe8072973ae53c30dbbf4eee1cc283a0c442/1.png?cb=96c383f1bac5b1452173c7993cbabc90) Allows you to select the type of the output: pivot table or pivot chart. ![2.png](https://documentation.stonikbyte.com/__attachments/a_280e3972763bdc2df729bdcafbcf304b60b7671607da9db7bb9f65a586f5ec78/2.png?cb=a82cc6a3d1407549175b8a52f7426c50) Configure the columns of the pivot table. You can place the necessary fields here using the drag \& drop functionality. ![3.png](https://documentation.stonikbyte.com/__attachments/a_5e9403f1a1c5dee3fe94c2f4a30a1cf6be008181e91174765ecf733707b001db/3.png?cb=015a15a31e5107d1fb70bd3e0bc226c9) Configure the rows of the pivot table. You can place the necessary fields here using the drag \& drop functionality. ![4.png](https://documentation.stonikbyte.com/__attachments/a_6eeaa37786916dd85853fc82a76d59652b3450171b16aa402d22d92334370e99/4.png?cb=134e9886e21ec20c4e092e60ecbaf6e6) The calculation method/formula. For example, to display the number of work items in table, select *Count* . To display the sum of an work item field (like Story Points), select *Sum* and then the select field. ![5.png](https://documentation.stonikbyte.com/__attachments/a_55b0e09ede947b92f21d90e6a294f43678cc68877dc8c47de38bb4cebc995563/5.png?cb=8d67d69c477983bd0ce49d90e9a54b02) A sample output of the gadget created using dummy data. ![6.png](https://documentation.stonikbyte.com/__attachments/a_29f5f7602f58ad8219e389d8979835bc033ba7084b83c85df8e2a61c57435c9c/6.png?cb=2cd244f5e5d868d49cc6ba58b6890b2e) Unused fields. **Note** If you drag \& drop a field between the columns area ![2.png](https://documentation.stonikbyte.com/__attachments/a_280e3972763bdc2df729bdcafbcf304b60b7671607da9db7bb9f65a586f5ec78/2.png?cb=a82cc6a3d1407549175b8a52f7426c50) and the rows area ![3.png](https://documentation.stonikbyte.com/__attachments/a_5e9403f1a1c5dee3fe94c2f4a30a1cf6be008181e91174765ecf733707b001db/3.png?cb=015a15a31e5107d1fb70bd3e0bc226c9) or vice versa, it will not be moved. Instead, it will be displayed on both places. This behavior is by design, because the gadget allows you to use a field in both rows and columns areas. To remove it from the columns area or from the rows area, just drag \& drop it into the unused fields area ![6.png](https://documentation.stonikbyte.com/__attachments/a_29f5f7602f58ad8219e389d8979835bc033ba7084b83c85df8e2a61c57435c9c/6.png?cb=2cd244f5e5d868d49cc6ba58b6890b2e) . | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Pivot chart - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_8d4c3baa0c533166309547a2e0bedbce06f17d6e73f9cbbc9008ceb3377f6539/Pivot%20chart%20-%20more%20settings%20tab.png?cb=b96018ecd9eacbe13a83cc9ea33a1383) | **Setting** | **Description** | |-----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Fields formatting mode** | For the fields that you selected on the Data tab for being used in the Pivot Table or Pivot Chart you may specify the format to be used for displaying their values. For example, for date fields like Created or Updated you can choose a format like "MM/dd/yyyy" or "yyyy", while for time fields like Time Spent or Original Estimate you may choose to display the result in "Hours" or "Calendar Days (24h)". To display quarters of the year, choose a format that contains "Q", such as "Q yyyy" or "yy-Q". To display weeks of the year, choose "Week dd MMM yy" or "Week of MMM dd, yyyy". Also, you can choose a format that contains "ww", such as "ww yyyy" or "yy-ww". | | **Make values clickable when possible** | Check this option if you want the gadget to display the calculated values as clickable links. Clicking a value will open a Jira filter that returns the work items contributing to that value. This option applies only when the gadget is configured as a Table, Table Heatmap, Table Col Heatmap or Table Row Heatmap with a ++maximum of one field++ per row and/or per column. If multiple fields are used in either area, the clickable functionality will be disabled. In some cases, the values ++may still not be clickable++ even if you check this option and only one field is used per row and/or per column. This can happen when: * a field that is not supported by the JQL searching is used in pivot table configuration. Examples of such fields are *Parent Epic - Type* , *Parent L3 - Type* or *Approvals - Approved*. * a field format that does not support JQL searching was selected on the **Fields formatting mode** from the **More Settings** tab. For the date / time fields only these formats allow clickable values: * "Week dd MMM yy" * "Week of MMM dd, yyyy" **Note:** Clicking a text field value may return additional items. This is due to a limitation in Jira Cloud's JQL, which does not support an exact-match operator for text fields. Please vote for [JRACLOUD-81881](https://jira.atlassian.com/browse/JRACLOUD-81881) to help bring visibility to this limitation and encourage Atlassian to address it soon. | | **Display the 'Totals' row** | Check this option if you want the pivot table to display the 'Totals' row. It takes effect only if the widget is configured as *Table* , *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. | | **Display the 'Totals' column** | Check this option if you want the pivot table to display the 'Totals' column. It takes effect only if the widget is configured as Table, *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. | | **Hide rows with zero totals** | Check this option if you want the pivot table to hide rows when their total value is zero. It takes effect only if the gadget is configured as *Table* or *Heatmap Table*. | | **Display the 'Percentage' column** | Check this option if you want the pivot table to display the 'Percentage' column. It takes effect only if the widget is configured as *Table* , *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. The percentage value on a row is calculated based on the value of the Total cell from the same row as a fraction of the Grand Total value. | | **Display the 'Average' column** | Check this option if you want the pivot table to display the 'Average' column. It takes effect only if the gadget is configured as *Table* , *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. You can choose to **Calculate the average based on**: * *all values* - the average will be calculated as the sum of cells divided by the number of cells * *non-zero values* - the average will be calculated as the sum of cells divided by the number of non-zero cells | | **Legend display** | This setting only applies to pivot charts. Indicates whether the chart legend should be displayed or not and where exactly. | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ### Colors tab On this tab you can choose the base color for the heatmap table or for the chart series. ![Pivot chart - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_3dff7f17662430210bde121f44a4965d574f96b2feac97b2d3fbdc72888f9124/Pivot%20chart%20-%20colors%20tab.png?cb=9fab1f6e1cc2b7c28c9d1582c7ad1ffe) | **Setting** | **Description** | |-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Heatmap base color** | This option lets you adjust the hue (color tone) used to generate the heatmap color palette. It applies only when the widget output is set to *Table Heatmap* , *Table Column Heatmap* , or *Table Row Heatmap*. The widget also automatically adjusts the text color based on the background color to ensure optimal readability. | | **Chart series color assignment** | This option lets you select how the colors will be applied to the series of the pivot charts. * **Automatically assign colors** - Check this if you want the chart to automatically assign colors for the series. * **Use custom colors** - Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or by picking a color. Use the **Add (+)** button to add entries to the table, then enter the series name as they appear in the chart legend and select a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## More Examples Here are more examples of using this gadget. ### Epics Progress There are various ways for displaying the progress of your epics. #### Epics by No. of Tasks in each Status Category ![image-20250717-084812.png](https://documentation.stonikbyte.com/__attachments/a_dc0f2481a0e1ff1d10afc2a04ea91d9c8a3741278e3568f5aff8353e8ee77c4a/image-20250717-084812.png?cb=70aad3c7ac0ead0283c9fce79b821827) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) under the epic. Make sure the filter doesn't return the epics themselves. Then configure the gadget to calculate the *Count* as in the example below. ![image-20250717-090102.png](https://documentation.stonikbyte.com/__attachments/a_173f70ba14da3c76a142a6da8ec92fb11fa3b016b590dbeaba53e6eb65bed043/image-20250717-090102.png?cb=a7c2d21a8233f2a56b5c52f6792aa6b3) #### Epics Progress By Percentage of Tasks in each Status Category ![image-20250717-084930.png](https://documentation.stonikbyte.com/__attachments/a_654b59e91d7477101d3b6efee59b39db2c06709badcefccd92661e066f19019c/image-20250717-084930.png?cb=8cb99ab71271fd288154303f1dbb2cca) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) under the epic. Make sure the filter doesn't return the epics themselves. Then configure the gadget to calculate the *Count as Fraction of Rows* as in the example below. ![image-20250717-090145.png](https://documentation.stonikbyte.com/__attachments/a_6e92204e5a89f7150f1d356a60a91029f6c655f1d18d8c4130418faa4421f79b/image-20250717-090145.png?cb=714c3784c3a3b2d396799cbddb170ca8) #### Epics by Sum of Story Points in each Status Category ![image-20250717-085430.png](https://documentation.stonikbyte.com/__attachments/a_9e92de09edbb4c21353e94421b1cf4a24b2c0e4e6ca7a7bd54846a198f0f4dfc/image-20250717-085430.png?cb=96441b3afbdfcfff953bbf6ba5b818f8) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) under the epic. Make sure the filter doesn't return the epics themselves. Then configure the gadget to calculate the *Sum* of*Story Points* as in the example below. ![image-20250717-090018.png](https://documentation.stonikbyte.com/__attachments/a_b656de765e3c4eae6af617fa672094003ef1952e998d3b4970e0ba2e38e3409a/image-20250717-090018.png?cb=35c13b3526ecd4c9b0de1f9836fba46e) #### Epics by Percent of Story Points in each Status Category ![image-20250717-085523.png](https://documentation.stonikbyte.com/__attachments/a_3440bcb9b7e10e8624887e6c222430f88a3d0e48b1f9a5b820c00e90fc2387fc/image-20250717-085523.png?cb=b7105bc4dfe3534c4aacc7925004f9b1) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) under the epic. Make sure the filter doesn't return the epics themselves. Then configure the gadget to calculate the *Sum As Fraction of Rows* for*Story Points* field as in the example below. ![image-20250717-085930.png](https://documentation.stonikbyte.com/__attachments/a_cac1350cf9470674e829325887afdc95f2e80aa94cea7799076f35538e961216/image-20250717-085930.png?cb=409a78e4e1cc41b929efc4c57a03a849) ### Progress of the Initiatives or Themes If you have initiatives or themes defined in your Jira Cloud instance as work item types on top of epics, you can easily track their progress. This gadget support stats by two levels above the epic; all you have to do us to use one of these fields: * **Parent of Epic** - for Hierarchy Level 2 work items (one level above epic) * **Parent L3** - for Hierarchy Level 3 work items (two levels above epic) ![image-20241010-085321.png](https://documentation.stonikbyte.com/__attachments/a_b71bb45d3a11bf5b581c0e320ea3bbc1576372ae0e7d480857e58b81b07b8140/image-20241010-085321.png?cb=62a691b60b4f9227b623ea5182bb7ebf) #### Initiatives or Themes by No. of Tasks in each Status Category split by work item type ![image-20241010-085733.png](https://documentation.stonikbyte.com/__attachments/a_942686a64a835039d29785c3e3e847d5d08fcf6e8ffdca4b74ed6992d295625d/image-20241010-085733.png?cb=ebfdbe6e7ac8bd36ca5f945faef91f8d) To achieve this, configure the gadget with a filter or JQL that returns the work items (stories, tasks, bugs, etc) under the initiative or theme. This is an example of JQL that returns all the work items from an initiative. key IN portfolioChildIssuesOf("DEMO-11") Make sure the filter doesn't return the initiatives or themes themselves. Then configure the gadget to calculate the *Count* as in the example below. ![Pivot---Parent-L3.png](https://documentation.stonikbyte.com/__attachments/a_c0bf3c8eca7ff714c0d50b098310503d05ff5d5f325d82d8f705982fb0867939/Pivot---Parent-L3.png?cb=9239b17b32b1cd487f98501fbf606c5c) #### Progress of Initiatives or Themes By Percentage of Tasks in each Status Category ![image-20250717-092151.png](https://documentation.stonikbyte.com/__attachments/a_4b5a50ad79d1545dbfa77526f3c30571d5bf8bc0c22f8c80c03166205d16ec70/image-20250717-092151.png?cb=4874e274115f0223bca172a7ca61b514) To achieve this, configure the gadget with a filter or JQL that returns the work items (stories, tasks, bugs, etc) under the initiative or theme. This is an example of JQL that returns all the work items from an initiative. key IN portfolioChildIssuesOf("DEMO-11") Make sure the filter doesn't return the initiatives or themes themselves. Then configure the gadget to calculate the *Count as Fraction of Rows* as in the example below. ![Pivot---Parent-L3-count-as-fractions-of-rows.png](https://documentation.stonikbyte.com/__attachments/a_53870b5936084ce5991e05ea612cddd5c0c6384949ef66f0f8bf027935d4472f/Pivot---Parent-L3-count-as-fractions-of-rows.png?cb=f189a527daffd0623b5194aa79fa0aaa) ### Projects Completion There are various ways for displaying the progress your projects. #### Projects by No. of Tasks in each Status Category ![image-20250717-090449.png](https://documentation.stonikbyte.com/__attachments/a_607a436f0d5fd70a6b8392942916c825e04a0f2e6ba586a859d4dc4ba3f180be/image-20250717-090449.png?cb=f7260213a8f472582b4c3b3c4740b3b0) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) from the projects that you want to track. Then configure the gadget to calculate the *Count*as in the example below. ![image-20250717-090528.png](https://documentation.stonikbyte.com/__attachments/a_9c418832abe15d5a0c5bc5faf7dbe68884b9911a89226ecefb668723aef2295b/image-20250717-090528.png?cb=2d960136003fb8d39a4e5448c5bb867e) #### Projects by Percentage of Tasks in each Status Category ![image-20250717-090629.png](https://documentation.stonikbyte.com/__attachments/a_3e7a4b8e259819a29e570e210355c0671b951865c51db8efc27ce5b320c44555/image-20250717-090629.png?cb=0a318ae33988c501db4bee2807a3a8e7) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) from the projects that you want to track. Then configure the gadget to calculate the *Count as Fraction of Rows*as in the example below. ![image-20250717-090604.png](https://documentation.stonikbyte.com/__attachments/a_ab1f48a7693864d1d0d7727d90a881f83b6de7df770f7d9ab73278af1d7010e3/image-20250717-090604.png?cb=6970c82c0f7e64add3661dfc54c31161) ### Sprint Velocity by Team Member ![image-20250717-091148.png](https://documentation.stonikbyte.com/__attachments/a_ecbcaf3d0e05fa216a474a5b98ddfd894f045b13c2865d2ff73fadb2f6ab4eb2/image-20250717-091148.png?cb=f7e5753a2a345d21367737d44223eeb6) ![image-20250717-090853.png](https://documentation.stonikbyte.com/__attachments/a_37b532d009fa7d69ab04fae8ecd4265f444f8b7603fa20d1316e9f40141e33e8/image-20250717-090853.png?cb=c89a22e7488e51de1cabf66a0076bb1a) ![image-20250717-090938.png](https://documentation.stonikbyte.com/__attachments/a_4cec3d914b29ad313cc1b7a519cf7ac1de37d662ab38fd079bff853963f49e42/image-20250717-090938.png?cb=4257f3c407a40569a34295220c3a2087) To achieve this, configure the gadget with a filter or JQL that returns work items (stories, tasks, bugs, etc) from the sprints that you want to track. Then configure the gadget to calculate the *Sum* of Story Pointsin the example below. ![image-20250717-091213.png](https://documentation.stonikbyte.com/__attachments/a_96b663fc3e9eac271ac17e971c5a071733b1fc0a591e659ec604b1494d91ad09/image-20250717-091213.png?cb=5f823aa06251c015084a14e33cac289d) On the More Settings tab, choose to display the 'Average' column. If you want the gadget output in form of a chart, choose *Stacked Column Chart* or *Line Chart* instead of *Table*. ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [How to measure customer satisfaction in Jira or Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/06/27/how-to-measure-customer-satisfaction-in-jira-or-confluence-with-great-gadgets-app/) * [How to display the progress of Epics, Initiatives and Themes in Jira or Confluence with Great Gadgets](https://blog.stonikbyte.com/2024/11/01/how-to-display-the-progress-of-epics-initiatives-and-themes-in-jira-or-confluence-with-great-gadgets/) * [Tracking Customer Sentiment in JSM with Great Gadgets for Jira](https://blog.stonikbyte.com/2025/02/14/tracking-customer-sentiment-in-jsm-with-great-gadgets-for-jira/) * [Approvals in Jira Service Management: How to Display Approval Data with Great Gadgets](https://blog.stonikbyte.com/2025/03/07/approvals-in-jira-service-management-how-to-display-approval-data-with-great-gadgets/) * [SLA Breaches in Jira: What they are, why they happen and how to track and prevent them using Great Gadgets for Jira](https://blog.stonikbyte.com/2025/06/20/sla-breaches-in-jira-what-they-are-why-they-happen-and-how-to-track-and-prevent-them-using-great-gadgets-for-jira/) * [7 Essential Team Performance Metrics To Track In Jira By Using Great Gadgets App](https://blog.stonikbyte.com/2025/08/14/essential-team-performance-metrics-to-track-in-jira-by-using-great-gadgets-app/) * --- language: "en" --- # Regional Clock Gadget ## Overview This gadget shows the current time in a specific location in a digital clock format. It is useful for companies with multiple offices across the world or geographically distributed teams. Use this gadget to let your team members know what the current time is in the other offices so they can better synchronize with the remote people. ![image-20240130-072610.png](https://documentation.stonikbyte.com/__attachments/a_d220a9093c18bd8ea0841e113006223b6673543bd2e34ff317dbce25fe3aaf8f/image-20240130-072610.png?cb=3e0874e03f42410a2e02d4e93c901e96) ![image-20240130-072644.png](https://documentation.stonikbyte.com/__attachments/a_ff37da04fd6d0c39f24160e226787775ed6d9278c5101140c93f2ed114bae658/image-20240130-072644.png?cb=bd686a5904043cee993b57b36cabcd61) ## Configuration On this tab you can configure the required settings of the gadget. ![image-20240130-072731.png](https://documentation.stonikbyte.com/__attachments/a_7c3f3ebfb3491ab4546b7dc183ab8e7292f100ed86c8ae2c6b41ec1ee14f6606/image-20240130-072731.png?cb=72e871e1077f8112cc74c9df2c20a644) | **Setting** | **Description** | |------------------|-------------------------------------------------------------------------| | **Gadget Title** | Choose what to display in the title bar of the gadget. | | **Top Line** | Specify the location to be displayed on the top line. | | **Region** | Select the region for which the time is to be displayed. | | **Time Zone** | Select the city or the time zone for which the time is to be displayed. | | **Show Date** | Check this if you want the current date to also be displayed. | --- language: "en" --- # Release Burndown Burnup Chart Gadget ## Overview This gadget displays the burnup and/or burndown chart for a project release represented by a Jira filter. The calculation can be done by Story Points, Original Time Estimate, Work Item Count or by any numerical custom field, relying on historical data for each item within the specified filter. Additionally, you have the option to include sub-tasks in the calculation. The series to be displayed are configurable, thus allowing you to use the gadget as burndown, burnup or both, providing a flexible tool to monitor the agile progress of your project release. Use this gadget to track the progress of your project release in an agile manner. ![image-20250807-095004.png](https://documentation.stonikbyte.com/__attachments/a_4a605b11736a3dd4ad2eb3c4c83bdb2092c05b588b1dd40be00886f7345cfd93/image-20250807-095004.png?cb=eed8a11f0814ed0197017e900314a499) ![image-20250807-094941.png](https://documentation.stonikbyte.com/__attachments/a_055b2b0adc4c57c2fb024ce0e6aebc5601629eae0bee4d372a3c15db972b25c3/image-20250807-094941.png?cb=20da51b22173128ae7d1b9253f0ca9a8) This gadget can also make a **forecast** (prediction) about when the release will be finished. How is the forecast made? First, the gadget determines the current velocity of your team based on the work done in the previous completed time intervals (Yesterday's Weather). Then, it determines how many days are necessary to finish the current remaining work, assuming that your velocity remains the same, and it draws the dashed line accordingly to the determined release end date. Optionally, you can choose to display the release **milestones**, such as at 25%, 50%, or 75% of the release timeframe. A past milestone will be displayed in red if the Remaining work at that time was higher than Ideal Burndown, or in green if it was lower, thus indicating if the milestone was reached or not. ![Release burndown chart with forecast and milestones.png](https://documentation.stonikbyte.com/__attachments/a_01de68449e3cd7ced71976e3182720ff06976e11aca8bed2724ef74158322cae/Release%20burndown%20chart%20with%20forecast%20and%20milestones.png?cb=e61d3fbe6a49e6410adc1b99f228880f) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **Series** tab - lets you choose what series (lines) to display in the chart * **Forecast** tab - contains settings for calculating the forecast lines * **Milestones** tab - lets you choose how to display milestones in the chart * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Release burndown burnup configuration - data tab.png](https://documentation.stonikbyte.com/__attachments/a_5489a6e7bbbeb1120878687966e228a3e6d8b6bfebde5083acb19e76589c1b88/Release%20burndown%20burnup%20configuration%20-%20data%20tab.png?cb=a091915f577fc29332dbb2efc3152d8e) | **Setting** | **Description** | |-----------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data source** used by the gadget: * A**Saved filter** that contains the Jira items in your release (the scope of your project release). Make sure that the specified filter is shared if you want other people to visualize the dashboard. * A **JQL** query that returns the items you want to be processed by the gadget. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** - Select one or more work items above the Epic level, such as Initiatives or Themes. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_ce0411f8b8de7bad3cd712da3470e9cb4e99c5828b7fd75c315d76fe24328f62/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Include sub-tasks** | Select this option if you want the calculation to include the sub-tasks along with their estimate. | | **Track scope by 'Fix versions'** | Select this option if you want to create version-based charts and track the release scope based on one or more values of the 'Fix versions' field. Make sure to enter the versions exactly as they are named in your projects. When enabled, the gadget will exclude all other issues from the selected data source and will consider as being in scope only the issues whose 'Fix versions' field matches one of the specified values. | | **Time range** | Represents the time interval of the release. You choose from multiple options: **Custom dates** - choose this option if you want to manually enter the *Start date* and *End date* of the release. **Dates of a project release** - Choose this option if you want the gadget to use the start and end dates of an existing project release (added on the Releases page of a Jira project). Make sure the selected release has a *Start date* and *End date* set. Any subsequent changes to the release dates made on the project's Releases page will be automatically reflected in the gadget, without the need to reconfigure it. **Dates of a sprint** - Choose this option if you want the gadget to use the start and end dates of an existing sprint. Only the dates are considered (not also the hours). The start of the interval will be the start date of the sprint with time at the start of day, while the end of the interval will be the end date of the sprint with the time at the end of day. When enabled, you'll need to select the board the sprint belongs to. If you choose the *Latest sprint (auto)* , the date range will automatically match the most recent sprint. If you choose the *Previous sprint (auto)*, the date range will automatically match the sprint immediately before the latest one. If you manually select a specific sprint, any changes made to its dates on the board will be automatically reflected in the gadget, without the need to reconfigure it. Be aware that you can also check the **Continue to display data after release end date** option in the **More Settings** tab if you want the chart to still display data even if the end date has passed. | | **Intervals of** | Indicates the time interval for calculating the chart data. If you do Agile development, this should be set according to the length of your sprints or iterations. | | **Calculate by** | Specify on which criteria the calculation to be performed. You can choose between: * **Story Points** - the default value; use this option if the work items are estimated in Story Points. If the work items are from team-managed spaces, select **Story Point Estimate** instead. * **Original Time Estimate** - use this if you use time estimates; calculation will be done in hours. The **Scope** will be calculated as the sum of the Original Estimate field of all the items from the filter, and each time an item is marked as done, the **Burned** and **Remaining** lines will increase/decrease with the amount of hours that is set at Original Estimate for that item. This option does not consider the time spent (work logged). * **Time Remaining \& Time Spent** - use this option if you use time estimates and your team logs the worked time on a daily basis; calculation will be done in hours. The **Scope** will be calculated as the sum of the Time Spent and Time Remaining of all the items from the filter. **Burned** is calculated as the sum of Time Spent of all the items from the filter plus the sum of Time Remaining of all the items from the filter that are done. **Remaining** is calculated as Scope minus Burned. This option does not consider the Original Estimate field. * **Work Item Count** - use this if you want the calculation to be done by the number of work items. * Other **numerical custom fields** defined in your Jira instance - pickup the numerical custom field that you use to track or estimate the work items. | ### Series tab On this tab you can choose what series to display in the chart. ![Release burndown burnup in Jira - series tab.png](https://documentation.stonikbyte.com/__attachments/a_844ded4e8bd5ec18c08c1ee4fd69b26fc4d23cb01244b679714cdc782ec0c91f/Release%20burndown%20burnup%20in%20Jira%20-%20series%20tab.png?cb=d5a331734d8977936d20cab489c05215) | **Setting** | **Description** | |-----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Series to Display** | Choose what series to display in the chart. You can select one or more options: **Ideal Burndown** - the ideal line specific to a burndown chart. It indicates how the remaining work should evolve in the ideal case. It is calculated based on Scope (see below). **Ideal Burnup** - the ideal line specific to a burnup chart. It shows how the done (burned) work should evolve in the ideal case. It is calculated based on Scope (see below). **Remaining** - the total amount of remaining work at that time; it is specific to the burndown chart. **Burned** - the total amount of work done at that time; it is specific to the burnup chart. **Scope** - represents the current release goal - the total amount of work to be done in the release at that time. Select this if you want to see the changes in the release scope over time. **Forecast Scope** - makes a forecast (prediction) abou the scope and displays it as a dashed line between the end of the Scope line and the release end date. **Forecast Burndown** - makes a forecast (prediction) about when the remaining work is finished and displays it as a dashed line between the start of the release and the estimated release end date. **Forecast Remaining** - makes a forecast (prediction) about when the remaining work is finished and displays it as a dashed line between the end of the Remaining line and the estimated release end date. **Forecast Burned** - makes a forecast (prediction) about when the remaining work is finished and displays it as a dashed line between the end of the Burned line and the estimated release end date. The calculation of forecast lines is based on the settings in the **Forecast** tab. | | **Calculate the ideal series based on** | Choose how the ideal series will be calculated. **The current scope** means that the Ideal Burndown line starts from a value that is the same as the current (latest) value of the Scope series, while **The initial scope** means that the Ideal Burndown line starts from a value that is the same as the value of the Scope series at the start of the release. You can also choose **A fix scope value of** and specify a number representing the total work estimate of the release. This third option is useful when you have a rough estimate of the total work but have not yet added all the corresponding work items or estimates in Jira. | **Tips \& Tricks** * To configure the gadget as a "classic" **burndown chart** , select only the **Ideal Burndown** and **Remaining** series. * To configure the gadget as a "classic" **burnup chart** , select only the **Ideal Burnup** and **Burned** series. * To configure it as an **epic burndown / burnup chart** configure the gadget to use a filter or JQL that returns the work items from your epic(s): *parentEpic in (EPIC-1, EPIC-2 ...)* ### Forecast tab On this tab you can define how the forecast lines are calculated. ![Release burndown burnup in Jira - foecast tab.png](https://documentation.stonikbyte.com/__attachments/a_11431885276d227143d26e7868962fd80cad2bda84df295105bdc10bf2363200/Release%20burndown%20burnup%20in%20Jira%20-%20foecast%20tab.png?cb=c08b5d70fb652f8f515a000a6c1cdd91) | **Setting** | **Description** | |-------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **End date forecast based on** | Specify how the end date forecast is calculated. **The average velocity of all the completed intervals** - by choosing this option the end date forecast will be calculated based on the average velocity (average amount of work completed) of all the completed time intervals from the chart. **The average velocity of the last** ***x*** **intervals** - by choosing this option the scope forecast will be calculated based on the average velocity (average amount of work completed) of the most recent *x* completed time intervals from the chart. **A fixed velocity of ...** - by choosing this option the scope forecast will be calculated based on a fixed velocity, entered manually. These settings affect all the forecast series, except **Forecast Scope**. | | **Consider the scope forecast when making the end date forecast** | By checking this option, the calculation of the end date forecast will also take into account the scope forecast, not just the velocity. | | **Scope forecast based on** | Specify how the scope forecast is calculated. **The average scope changes of all the completed intervals** - by choosing this option the scope forecast will be calculated based on the average scope change ratio of all the completed time intervals from the chart. **The average scope changes of the last** ***x*** **intervals** - by choosing this option the scope forecast will be calculated based on the average scope change ratio of the most recent *x* completed time intervals from the chart. **A fixed scope change ratio of ...** - by choosing this option the scope forecast will be calculated based on a fixed change scope ratio, entered manually. These settings affect the **Forecast Scope** series, as well as the other forecast series if the **Consider the scope forecast when making the end date forecast** is checked. | ### Milestones tab On this tab you can configure how milestones are displayed in the gadget. ![Release burndown burnup configuration - milestones tab.png](https://documentation.stonikbyte.com/__attachments/a_bf89b6fb9e585e3aa0bb590c0a40f2a8f035aa86608b06e159795d75e491110b/Release%20burndown%20burnup%20configuration%20-%20milestones%20tab.png?cb=32fb47822d4148a4536f7c66f3e40eb2) | **Setting** | **Description** | |------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------| | **Display milestones** | Enable this option to display your configured milestones in the gadget. | | **Timeline percentage milestones** | Enter the percentages values corresponding to the milestones to be displayed. | | **Date-only milestones** | Enter the dates corresponding to the milestones to be displayed in either DD.MM.YY or MM/DD/YY format. | | **Milestones with custom labels** | Select a milestone's date and enter a custom label to be displayed in the gadget. You can add a new milestone by clicking the "+" button. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Release burndown burnup configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_e6e591a0bdf9b2698ac94211c2e3be87c4ec86d0cdaffc72cab0c26279e49d6a/Release%20burndown%20burnup%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=a65c1d0bab198f6a89fcdd05744046ff) | **Setting** | **Description** | |-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **"Done" means** | Specify how the gadget should consider work items as done when determining the work completed. The default option is **Work item status has the category done**, which means that the item is considered done if it has reached a "done" category status (such as Resolved, Closed, Done or any other green-colored status of Jira). Choose **Work item is in last column of the selected board** and select an agile board if you want to consider items as done when they reach the last column of the board or, more exactly, a status that is mapped to the last board column. Choose**Work item is in one of these statuses,** and then select one or more workflow statuses, to consider items as done when they reach one of these custom statuses. | | **Show legend** | Check this if you want the chart legend to be displayed. | | **Display data values at the top of the chart** | Check this option if you want the gadget to display key data values (like planned dates, ETA, days left, burned, remaining, scope) at the top of the chart. When possible, these values include a link that opens a filter containing the work items that produced that value. | | **Continue to display data after release end date** | Check this option if you want the chart to still display data even if the release date has passed. When this option is checked, the chart lines Scope, Remaining, Burned and forecast will continue after the release end date. | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Enable scroll zoom** | Check this if you want to be able to zoom in while scrolling with the mouse wheel over the chart. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some resulting data after processing is saved and reused the next time the gadget is loaded. If you check it, the cache of the gadget will be cleared and recreated on the next reload. This setting is not persistent. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Release burndown burnup configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_9877fb57da3c493ad26631c2ee130922ac9ac509671dd1226528ffbf5a23bb50/Release%20burndown%20burnup%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=487f4ca79dd3b96dcfc09a76ed348573) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [Cross-team release burndown chart in Jira with Great Gadgets app](https://blog.stonikbyte.com/2020/03/23/cross-project-release-burndown-chart-in-jira-with-great-gadgets-app/) * [A powerful Reported vs Done chart for Jira dashboards](https://blog.stonikbyte.com/2020/04/21/a-powerful-reported-vs-done-chart-for-jira-dashboards/) * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [Tracking an agile project that uses time estimates with Great Gadgets for Jira](https://blog.stonikbyte.com/2021/03/08/tracking-an-agile-project-that-uses-time-estimates-with-great-gadgets-for-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [How to create an epic burndown or burnup chart in Jira and Confluence with Great Gadgets app](https://blog.stonikbyte.com/2024/06/05/how-to-create-an-epic-burndown-or-burnup-chart-in-jira-and-confluence-with-great-gadgets-app/) * [How to display the progress of Epics, Initiatives and Themes in Jira or Confluence with Great Gadgets](https://blog.stonikbyte.com/2024/11/01/how-to-display-the-progress-of-epics-initiatives-and-themes-in-jira-or-confluence-with-great-gadgets/) --- language: "en" --- # Release Notes This page contains the version change-log for [Great Gadgets for Jira Cloud](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?hosting=cloud&tab=overview). The version history of [Great Gadgets for Jira Data Center](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis?hosting=datacenter&tab=overview) can be found [here](https://marketplace.atlassian.com/apps/1218777/great-gadgets-for-jira-dc-agile-charts-reports-kpis/version-history). Version 20.42.0, released 15-OCT-2026 * Minor improvements Version 20.41.0, released 14-OCT-2026 * Added an option to hide rows with zero totals in the Pivot Table \& Pivot Chart Gadget and Worklog Reports \& Timesheets Gadget * Fixed visibility issues in dark mode in the Histogram Chart gadget * Added dashboard widgets: WIP Run Chart, WIP Aging Chart, Sprint Burndown \& Burnup Chart, Release Burndown \& Burnup Chart Version 20.40.0, released 13-OCT-2026 * Added a new display option to show values above each column as percentages, counts, or both in the Histogram Chart gadget Version 20.39.0, released 06-OCT-2026 * Minor changes Version 20.38.0, released 02-OCT-2026 * Made the **Cumulative Flow Diagram Chart** and **Time in Status** gadgets available as widgets for use in new space dashboards (under the **Reports** section in Jira spaces) and on the **Atlassian Home Dashboard**. * Fixed some of the app dependencies. Version 20.37.0, released 01-OCT-2026 * Minor changes Version 20.36.0, released 01-OCT-2026 * Minor changes Version 20.35.0, released 29-SEP-2026 * Added key numbers at the top of the Cumulative Flow Diagram (CFD) gadget when using Work Item Status Categories or Board Column Categories, providing a quick overview of the most important metrics. * Improved the display of issues when Sprint is selected as the data source in the Work Breakdown Structure (WBS) gadget. Version 20.34.0, released 28-SEP-2026 * * Minor fixes Version 20.33.0, released 25-SEP-2026 * * Added 'Unfinished' and '% Unfinished' metrics to the Team Velocity gadget to track unfinished work at the end of each sprint. * Reorganized the Team Velocity gadget settings by introducing a separate Series tab. Version 20.32.0, released 24-SEP-2026 * * Minor changes Version 20.31.0, released 22-SEP-2026 * Improved status detection in the WIP Aging Chart gadget Version 20.30.0, released 18-SEP-2026 * Minor fixes Version 20.29.0, released 18-SEP-2026 * Fixed date formatting in the Work Breakdown Structure (WBS) gadget * Fixed a sorting issue with the Status Category field in the Pivot Table \& Pivot Chart gadget Version 20.26.0, released 16-SEP-2026 * Minor fixes Version 20.25.0, released 16-SEP-2026 * Minor fixes Version 20.24.0, released 15-SEP-2026 * Added an option to display the Data table below the chart across multiple gadgets * Upgraded several app dependencies to improve stability and compatibility Version 20.23.0, released 10-SEP-2026 * Enhanced the Data Table appearance in gadgets with the "Show data tab" setting. Version 20.22.0, released 03-SEP-2026 * Changed the default selection of the Calculate by field to Work Item Count in the Kanban Velocity/Throughput gadget and WIP Run Chart gadget. Version 20.21.0, released 01-SEP-2026 * Added navigation links to Boards and Filters in gadget settings. * Improved the Work Breakdown Structure (WBS) gadget by displaying the count of linked items for each link type. Version 20.20.0, released 31-AUG-2026 * Added Epics and Portfolio-level items as Data source options for: Pivot Table \& Pivot Chart Gadget, Worklog Reports \& Timesheets Gadget, Work Breakdown Structure (WBS) Gadget, Cumulative Flow Diagram (CFD), Release Burndown Burnup Chart, WIP Run Chart, and WIP Aging Chart Gadget. Version 20.19.0, released 25-AUG-2026 * Minor fixes Version 20.18.0, released 21-AUG-2026 * Minor fixes Version 20.17.0, released 19-AUG-2026 * Improved data processing in the Time in Status gadget when grouping data by a selected field. Version 20.16.0, released 19-AUG-2026 * Restricted the math functions allowed in the Issue Filter Formula and Advanced Issue Filter Formula gadgets to improve security * Improved the safe handling of color codes used in color customizations * Other minor fixes and improvements Version 20.15.0, released 17-AUG-2026 * Allow the ORDER BY clause in the Work Breakdown Structure (WBS) gadget JQL for data sorting Version 20.14.0, released 07-AUG-2026 * Upgraded some of the app dependencies Version 20.13.0, released 05-AUG-2026 * Improved numeric value formatting on chart axes and tooltips in the Pivot Table \& Pivot Chart gadget and Worklog Reports \& Timesheets gadget by displaying values in their original format Version 20.12.0, released 04-AUG-2026 * Added the "Parent Epic -- Due Date", "Parent of Epic -- Due Date", and "Parent L3 -- Due Date" fields to the Pivot Table \& Pivot Chart gadget and the Worklog Reports \& Timesheets gadget. * Fixed the display format of time field values in the WBS gadget. Version 20.10.0, released 27-JUL-2026 * Added placeholder text to the Rows, Columns, and Unused Fields areas in the Pivot Table and Pivot Chart gadget configuration Version 20.9.0, released 23-JUL-2026 * Added the "Previous sprint (auto)" option to the Sprint selector in the Sprint Burndown Burnup Chart and Cumulative Flow Diagram (CFD) gadgets, as well as to gadgets that support the "Date of a Sprint" time range option. * Improved the Work Breakdown Structure (WBS) gadget by merging the cells in the row containing the filter name Version 20.8.0, released 21-JUL-2026 * Minor fixes Version 20.7.0, released 20-JUL-2026 * Minor fixes Version 20.6.0, released 20-JUL-2026 * Fixed gadget sizing issues in Kanban Velocity/Throughput and Cycle Time Trend gadgets Version 20.4.0, released 16-JUL-2026 * Added support for selecting custom fields in the Work Breakdown Structure (WBS) gadget. * Increased the maximum linked issue depth in the Work Breakdown Structure (WBS) gadget from 3 to 5 levels. Version 20.3.0, released 08-JUL-2026 * Upgraded some of the app dependencies Version 20.2.0, released 03-JUL-2026 * Performance improvements for the Cumulative Flow Diagram (CFD), Release Burndown/Burnup Chart, Sprint Burndown/Burnup Chart, and WIP Run Chart gadgets. Version 20.1.0, released 30-IUN-2026 * Added a new "Linked issue depth" option to the Work Breakdown Structure (WBS) gadget to control how many levels of linked work items are displayed Version 20.0.0, released 28-IUN-2026 * Added permission needed for using Forge storage Version 19.28.0, released 26-IUN-2026 * Added a new "Link types to display" configuration option to the Work Breakdown Structure (WBS) gadget. It allows the display of all link types or only selected link types when using the "Linked Work Items View" visualization mode. Version 19.27.0, released 25-IUN-2026 * Added a new "Link types to display" configuration option to the Work Breakdown Structure (WBS) gadget. It allows the display of all link types or only selected link types when using the "Linked Work Items View" visualization mode. Version 19.26.0, released 23-IUN-2026 * Minor fixes Version 19.25.0, released 22-IUN-2026 * Added a new "Link types to display" configuration option to the Work Breakdown Structure (WBS) gadget. It allows the display of all link types or only selected link types when using the "Linked Work Items View" visualization mode. Version 19.24.0, released 19-IUN-2026 * Fixed a duplication issue in the Release Burndown Burnup Chart when tracking scope by Fix Versions Version 19.23.0, released 18-IUN-2026 * Improved the Advanced Issue Filter Formula Gadget configuration with Add variable and Add formula buttons, allowing additional variables and formulas to be added on demand Version 19.22.0, released 17-IUN-2026 * Added a new Sprint data source option to the Cumulative Flow Diagram (CFD) gadget Version 19.21.0, released 12-IUN-2026 * Added the new *Track scope by 'Fix versions'* option to the Release Burndown Burnup Chart, allowing release scope to be tracked based on one or more specified Fix Version values. Version 19.19.0, released 08-IUN-2026 * Upgraded some of the app dependencies Version 19.17.0, released 27-MAY-2026 * Added a new button for showing or hiding the JQL editor in the Great Gadgets Controller Version 19.16.0, released 24-MAY-2026 * Added intervals of type "Board Sprints" in Cycle Time Trend gadget Version 19.15.0, released 20-MAY-2026 * Fixed a data processing issue that could prevent some gadgets from loading correctly Version 19.14.0, released 18-MAY-2026 * Upgraded some of the app dependencies Version 19.13.0, released 14-MAY-2026 * Upgraded some of the app dependencies Version 19.10.0, released 13-MAY-2026 * Minor internal fixes Version 19.8.0, released 11-MAY-2026 * Changed the default base color of heatmap tables from red to blue in Pivot Table \& Pivot Chart gadget. * This version includes an updated End User License Agreement (EULA) v1.7, containing revisions to align with the latest [Master Services Agreement (MSA)](https://stonikbyte.com/msa.html) v1.1. Version 19.7.0, released 08-MAY-2026 * Added the ability to customize chart series colors in the Pivot Table \& Pivot Chart gadget. Version 19.6.0, released 06-MAY-2026 * Added support for saved JQL presets in the Controller Gadget Version 19.5.0, released 01-MAY-2026 * Minor fixes related to AGC Version 19.4.0, released 30-APR-2026 * Minor fixes Version 19.3.0, released 29-APR-2026 * Fixed an issue caused by missing values in issue change history that could prevent some gadgets from loading correctly Version 19.2.0, released 28-APR-2026 * Added a new gadget: Great Gadgets Controller, which allows you to control other Great Gadgets on the dashboard by applying additional filters Version 19.1.0, released 24-APR-2026 * Fixed an issue related to the detection of the Story Points field. Version 19.0.0, released 23-APR-2026 * Minor fixes Version 18.0.0, released 17-APR-2026 * Minor fixes Version 17.0.0, released 16-APR-2026 * Minor fixes Version 16.0.0, released 10-APR-2026 * Ability to visualize data across past time intervals (not just recent ones) in the Kanban Velocity / Throughput gadget. Version 15.0.0, released 08-APR-2026 * Fixes to ensure backward compatibility with older app versions Version 14.0.0, released 06-APR-2026 * Minor fixes Version 13.0.0, released 03-APR-2026 * Added 1-calendar month interval option in Cumulative Flow Diagram and WIP Run Chart gadgets * Added two more preset options in Worklog Reports \& Timesheets gadget * Updated Get Started page * Other minor fixes Version 12.0.0, released 31-MAR-2026 * Fixed a filtering issue in the Pivot Table and Pivot Chart gadget Version 11.0.0, released 30-MAR-2026 * Added support for custom milestone labels in the Release Burndown Burnup Chart gadget. Version 10.0.0, released 24-MAR-2026 * Minor fixes Version 9.0.0, released 19-MAR-2026 * Upgraded some of the app dependencies Version 8.62.0, released 17-MAR-2026 * Added support for custom milestone dates for all interval types in the Release Burndown Burnup Chart. Version 8.61.0, released 13-MAR-2026 The version includes the following fixes and improvements: * Fixed availability of some fields in Pivot Table \& Pivot Chart gadget * This version comes with EULA v1.6, which includes references to the StonikByte Master Services Agreement (MSA) as part of the legal framework governing the use of the Software. Find more details about the StonikByte Master Services Agreement (MSA) click [here](https://stonikbyte.com/msa.html). Version 8.60.0, released 10-MAR-2026 * Added a**Worklog Total** field to the *Worklog Reports \& Timesheets* gadget, displaying the total work logged within the selected time interval. Version 8.59.0, released 06-MAR-2026 * Advanced Edition - display benefits on app configuration page under Jira administration Version 8.58.0, released 05-MAR-2026 * Fixed time-zone processing issues in Release Burndown Burnup Chart and Cycle Time Trend Chart gadgets Version 8.57.0, released 03-MAR-2026 * Advanced Edition containing: * `Timesheets & Worklog Reports gadget` * `Priority Support` * `Expert Enablement Sessions` * `Migration Assistance` Version 8.57.0, released 03-MAR-2026 * Advanced Edition containing: * `Timesheets & Worklog Reports gadget` * `Priority Support` * `Expert Enablement Sessions` * `Migration Assistance` Version 8.56.0, released 03-MAR-2026 * Minor fixes Version 8.55.0, released 27-FEB-2026 * Support for Data Residency - ability to choose in which region (USA, EU Ireland, India or Australia) the app data is stored. Version 8.54.0, released 27-FEB-2026 * Minor version Version 8.53.0, released 26-FEB-2026 * Minor fixes Version 8.52.0, released 18-FEB-2026 * Minor fixes Version 8.51.0, released 17-FEB-2026 Enhancements to the WIP Run Chart gadget: * Ability to split WIP by a selected field (e.g., Priority or Project). When enabled, the chart displays a separate line for each value of the chosen field. * Ability to choose whether the Total WIP line is displayed in the chart. * Option to display the actual values for each line directly on the chart. * Fixed date processing issue caused by time-zone Version 8.50.0, released 16-FEB-2026 * Minor fixes and improvements Version 8.49.0, released 13-FEB-2026 * Minor fixes and improvements Version 8.48.0, released 11-FEB-2026 * Minor fixes and improvements Version 8.47.0, released 09-FEB-2026 * Minor fixes and improvements Version 8.46.0, released 02-FEB-2026 * Minor fixes Version 8.45.0, released 26-JAN-2026 * Upgraded some of the app dependencies Version 8.44.0, released 24-JAN-2026 * Minor fixes and small improvements Version 8.43.0, released 23-JAN-2026 * Use term "work item" instead of "issue" in the on-screen texts to be inline with the Jira Cloud terminology Version 8.42.0, released 21-JAN-2026 * Updated documentation links in all gadgets Version 8.41.0, released 20-JAN-2026 * Minor version update improving performance and stability across multiple gadgets Version 8.40.0, released 19-JAN-2026 * Improvements in Pivot Table \& Pivot Chart gadget Version 8.39.0, released 16-JAN-2026 * Minor version update -- performance and stability improvements Version 8.38.0, released 16-JAN-2026 * Minor fixes Version 8.37.0, released 09-JAN-2026 * Fixed the appearance of the message in Confluence Cloud when the required connector is not installed 2025 Version 8.36.0, released 30-DEC-2025 * Fixed CSV export problem in WIP Aging Chart and Control Chart gadget * Other minor fixes Version 8.35.0, released 17-DEC-2025 * Minor internal fixes Version 8.34.0, released 16-DEC-2025 * Performance optimizations across different gadgets Version 8.33.0, released 13-DEC-2025 * Performance improvements in various gadgets Version 8.32.0, released 10-DEC-2025 * Fixed data caching error for large cache entries Version 8.29.0, released 04-DEC-2025 * Improved performance when displaying gadgets for filters returning many issues Version 8.28.0, released 28-NOV-2025 * Minor fixes Version 8.27.0, released 28-NOV-2025 * Minor version update Version 8.26.0, released 26-NOV-2025 * Minor fixes Version 8.25.0, released 25-NOV-2025 * Enhanced performance for the Control Chart gadget by optimizing changelog data Version 8.24.0, released 20-NOV-2025 * Add support for adding custom milestone dates to the Release Burndown Burnup Chart Version 8.23.0, released 19-NOV-2025 * Fixed a data caching problem in the Team Velocity gadget Version 8.21.0, released 19-NOV-2025 * Fixes to ensure backward compatibility with older app versions Version 8.20.0, released 17-NOV-2025 * Minor fixes Version 8.19.0, released 16-NOV-2025 * Minor fixes Version 8.18.0, released 15-NOV-2025 * Minor fixes Version 8.17.0, released 11-NOV-2025 * Added a new option, "Linked Issues View", in the Work Breakdown Structure (WBS) Gadget to display issues together with their linked issues and statuses Version 8.16.0, released 10-NOV-2025 * Minor fixes Version 8.13.0, released 06-NOV-2025 * Fixed JQL issue in the Pivot Table \& Pivot Chart gadget when clicking a value generated by the Parent Epic field * Improved error handling in the WIP Aging Chart gadget Version 8.12.0, released 05-NOV-2025 * Minor fixes Version 8.11.0, released 04-NOV-2025 * Redesigned the UI of the Work Breakdown Structure (WBS) Gadget Version 8.10.0, released 03-NOV-2025 * Added option to process the subtasks in Sprint Burndown Burnup Chart and Team Velocity gadgets * Other minor fixes and improvements Version 8.9.0, released 28-OCT-2025 * Fixed an issue specific to the AGC environment Version 8.8.0, released 23-OCT-2025 * Fixed data display issue in Sprint Burndown Burnup gadget * Adjusted color range limit in Issue Filter Formula gadget Version 8.7.0, released 21-OCT-2025 * Added a new option to calculate and display progress based only on sub-tasks in the Sprint Burndown Burnup and Team Velocity gadgets * Added the ability to customize the color of WIP limit in the Colors tab of the WIP Run Chart gadget Version 8.6.0, released 16-OCT-2025 * Added *Time interval* label on top of the WIP Run Chart gadget Version 8.5.0, released 14-OCT-2025 * Added new options for setting Maximum and Minimum WIP limits in the WIP Run chart * Display key numbers at the top of the WIP Run chart, with the *Current* key clickable, opening the corresponding JQL filter Version 8.4.0, released 03-OCT-2025 * Minor fixes Version 8.3.0, released 02-OCT-2025 * Renamed the field *Story Points Estimate (NextGen Projects)* to *Story Point Estimate* in gadgets that use this field Version 8.2.0, released 30-SEP-2025 * Added option to extra-highlight the displayed values in both Issue Filter Formula and Advanced Issue Filter Formula gadgets Version 8.0.0, released 25-SEP-2025 * Removed the Connect modules that are no longer needed Version 7.5.0, released 24-SEP-2025 * Extended the Advanced Issue Filter Formula gadget to allow up to 9 variables to be used (instead of 6) Version 7.4.0, released 23-SEP-2025 * Ability to configure colors for value ranges in Advanced Issue Filter Formula gadget * Made the key-numbers displayed in top of the chart values clickable for Release Burndown Burnup Chart gadget when configured to calculate by Time Remaining \& Time Spent * Fixed issue in Pivot Table \& Pivot Chart gadget that occurs when two Project fields exist in Jira Version 7.3.0, released 23-SEP-2025 * Ability to configure colors for value ranges in Advanced Issue Filter Formula gadget * Made the key-numbers displayed in top of the chart values clickable for Release Burndown Burnup Chart gadget when configured to calculate by Time Remaining \& Time Spent * Fixed issue in Pivot Table \& Pivot Chart gadget that occurs when two Project fields exist in Jira Version 7.2.0, released 3-SEP-2025 * Added new option to exclude breaches from average calculation in Control Chart and Histogram Chart gadgets * Increased issue display limit to 1000 in the Data tab for Control Chart and Histogram Chart gadgets, and for Time in Status gadget *when configured with "Group data by: None"* Version 7.1.0, released 1-SEP-2025 * Fixed displaying the last day of the interval in the Release Burndown Burnup gadget Version 7.0.0, released 26-AUG-2025 * Added "Issue reached one of these statuses" option in Kanban Velocity / Throughput gadget * Added 1-day interval option in Kanban Velocity / Throughput gadget * Replaced required permission "manage:jira-configuration" with "read:workflow:jira" Version 6.40.0, released 21-AUG-2025 * Fixed calculation problem in Team Velocity gadget when configured by custom done statuses Version 6.39.0, released 20-AUG-2025 * Fixed an issue with JQL queries in Confluence Cloud Version 6.38.0, released 20-AUG-2025 * Minor fixes Version 6.37.0, released 19-AUG-2025 * Fixed an issue where clicking on the Scope or Burned links in the Release Burndown Burnup gadget * Upgraded some of the app dependencies * Other minor improvements and adjustments Version 6.36.0, released 15-AUG-2025 * Minor GUI improvements and adjustements Version 6.34.0, released 11-AUG-2025 * Fixed issue counting for WIP Run Chart gadget Version 6.29.0, released 07-AUG-2025 * Display the key numbers on top of the WIP Aging Chart * Display the "Days left" and "Planned dates" on top of the chart in Release Burndown Burnup Chart gadget * Display the "Days left", sprint name and sprint dates on top of the chart in Sprint Burndown Burnup Chart gadget * Other minor GUI improvements in various gadgets Version 6.28.0, released 02-AUG-2025 * Better handling of the error "403 Forbidden" * End User License Agreement (EULA) v1.5 containing a new section "Data Processing and GDPR Compliance" and updates in the existing section "Publicity rights" Version 6.27.0, released 02-AUG-2025 * Better handling of the error "403 Forbidden" * Fixed a scrolling issue when zooming-in on charts Version 6.26.0, released 29-JUL-2025 * Fixed the Team field display issue in the Pivot Table \& Pivot Chart gadget Version 6.25.0, released 24-JUL-2025 * Fixed breaches count in Control Chart gadget Version 6.24.0, released 23-JUL-2025 * Made the values of the team field clickable in the Pivot Table \& Pivot Chart gadget Version 6.23.0, released 23-JUL-2025 * Fixed the parent fields display issue in the Pivot Table \& Pivot Chart gadget Version 6.22.0, released 21-JUL-2025 * Fixed the status color display in the Work Breakdown Structure (WBS) gadget Version 6.21.0, released 18-JUL-2025 * Display issue assignee in the tooltip and the data tab of the Control Chart and WIP Aging Chart gadgets * Fixed label display in the Multiple Pie Chart of the Pivot Table \& Pivot Chart gadget * Other minor GUI fixes Version 6.20.0, released 17-JUL-2025 * Added key numbers on top of the chart in the Cycle Time Trend gadget Version 6.19.0, released 15-JUL-2025 * Display percentages on axes in all the charts of the Pivot Table \& Pivot Chart gadget when configured to calculate as a fraction * Displays values in multiple pie chart of the Pivot Table \& Pivot Chart gadget if only one chart is displayed * Made the option "Make values clickable when possible" checked by default in the Pivot Table \& Pivot Chart gadget Version 6.18.0, released 14-JUL-2025 * Added key numbers on top of the chart in the Kanban Velocity gadget Version 6.17.0, released 10-JUL-2025 * Added option to show key numbers at the top of the Release Burndown Burnup and Sprint Burndown Burnup charts (with clickable values when available) * Added setting option that allow values to be clickable in Pivot Table \& Pivot Chart gadget when configured to display as Table or Heatmap Table * Fixed 1 calendar month display in Cycle Time Trend gadget Version 6.16.0, released 03-JUL-2025 * Added option to ignore time logged before the start of the sprint in Sprint Burndown Burnup gadget Version 6.15.0, released 01-JUL-2025 * Redesigned the UI of the Countdown gadget Version 6.14.0, released 01-JUL-2025 * Added "Week of" date formatting options in Pivot Table and Pivot Chart gadget * Made values clickable in Pivot Table \& Pivot Chart gadget to open the corresponding JQL filter * Displayed the **Percentage** column in Pivot Table and Pivot Chart gadget * Improved the UI in Issue Filter Formula gadget Version 6.13.0, released 30-IUN-2025 * Fixed initiatives display in Work Breakdown Structure (WBS) gadget Version 6.12.0, released 24-IUN-2025 * Ensured percentages are shown with 2 decimal places in the Team Velocity gadget Version 6.11.0, released 23-IUN-2025 * Improved GUI in Team Velocity gadget and display 'Avg % Completed' on top of the chart when '% Completed' series is enabled Version 6.10.0, released 21-IUN-2025 * Fixed a time-zone id parsing error Version 6.9.0, released 20-IUN-2025 * Added the ability to set sprint dates in the date selector used by the gadgets (Release Burndown Burnup, Cumulative Flow Diagram (CFD), WIP Run, Control Chart, Histogram) Version 6.8.0, released 13-IUN-2025 * Upgraded some of the app dependencies Version 6.7.0, released 13-IUN-2025 * Upgraded some of the app dependencies Version 6.6.0, released 12-IUN-2025 * Show key numbers at the top of the histogram chart * Improved x-axis in histogram chart to reflect custom split thresholds * GUI tweaks and improvements for several gadgets Version 6.5.0, released 11-IUN-2025 * Fixes in the Control Chart, Histogram Chart, and Cycle Time Trend Chart gadgets related to processing and displaying issues with multiple cycles Version 6.4.0, released 11-IUN-2025 * Added *Parent of Epic - Type* and *Parent L3 - Type* as supported fields in Pivot Table \& Pivot Chart gadget that display the type of the parents above the epics * Fixed formula validation error in Advanced Issue Filter Formula gadget when using the *SQRT* function Version 6.3.0, released 03-IUN-2025 * Ability to open the Data tab first in all the gadgets that offer the Data tab * Improved display of key metrics on top of the Control Chart gadget * Upgraded some of the app dependencies Version 6.2.0, released 29-MAY-2025 * Font size adjustments in Advanced Issue Filter Formula gadget Version 6.1.0, released 28-MAY-2025 * Ability to set custom colors to the formula cards in Advanced Issue Filter Formula gadget * Improved the display of the formula cards in Advanced Issue Filter Formula gadget * Fixed compatibility issues with Table Transformer macro for Confluence Version 6.0.0, released 22-MAY-2025 * Ability to configure a custom display order for statuses in the Time in Status gadget * Ability to configure inline text display for Advanced Issue Filter Formula gadget * Fixed issues in the data displayed in sprint report of the Sprint Burndown Burnup Chart gadget Version 5.1.0, released 16-MAY-2025 * Fixed issue icons display in Team Wallboard and WBS gadgets * Fixed issues display in Data tab of the Sprint Burndown Burnup Chart gadget Version 5.0.0, released 12-MAY-2025 This new version comes with the following new features and improvements: * Support for asset fields in Pivot Table \& Pivot Chart gadget. The new scope read:cmdb-object:jira is now required. Version 4.0.0, released 29-APR-2025 Minor fixes and improvements Version 3.0.0, released 01-APR-2025 This is a major release update that migrates the app from the Atlassian Connect app development platform to the new Atlassian Forge platform. This is a necessary change as Atlassian has announced the retirement of the Atlassian Connect platform in the near future (see [Announcing Connect End of Support: Timeline and Next Steps](https://www.atlassian.com/blog/developer/announcing-connect-end-of-support-timeline-and-next-steps)). There are no changes in terms of app features or gadget functionality. What is the impact of this upgrade? After upgrading to this new version, the existing dashboard gadgets in your Jira Cloud instance will continue to work as before and no specific action is required. But, if you also have [Great Gadgets for Confluence Cloud](https://marketplace.atlassian.com/apps/1226592/great-gadgets-for-confluence-agile-charts-custom-reports?hosting=cloud&tab=overview) app installed in your Confluence Cloud instance, the macros from Confluence pages might stop working. To restore their functionality please also install [StonikByte Connector for Jira Cloud](https://marketplace.atlassian.com/apps/1226583/stonikbyte-connector-for-jira-cloud?hosting=cloud&tab=overview) (free app) in your Jira Cloud instance. For any questions, please contact [StonikByte Support](https://stonikbyte-production.atlassian.net/servicedesk/customer/portal/1). --- language: "en" --- # Sprint Burndown Burnup Chart Gadget ## Overview This gadget displays the burnup and/or burndown chart for a specified sprint. The calculation can be done by Story Points, Original Time Estimate, Time Remaining \& Time Spent, Work Item Count or by any numerical custom field, relying on historical data of every work item in the sprint. You can also choose to include the sub-tasks in the calculation. The series to be displayed are configurable, thus allowing you to use the gadget as burndown, burnup or both. Use this gadget effectively monitor the progress of your team throughout the sprint. ![image-20250807-095547.png](https://documentation.stonikbyte.com/__attachments/a_a120b798deacad495058983665ab6456bd51dccc93640a67617da0627905fa97/image-20250807-095547.png?cb=450c3fab523af578810b3748aafaf4b7) ![image-20250807-095645.png](https://documentation.stonikbyte.com/__attachments/a_4b466dd15b000e4ff5f2f306c28699446e7708f4a016985aa73f517cb6d7a749/image-20250807-095645.png?cb=10b20927868428dc7929fbddd147e00d) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings, such as card colors * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Sprint burndown burnup configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_4ea3db14efa3708a7549603c9d5b57a96109d4b36694a3b59e9f6bad12136eb2/Sprint%20burndown%20burnup%20configuration%20in%20Jira%20-%20data%20tab.png?cb=6c9c18a2cce9849f90d5b221c1d7eb9f) | **Setting** | **Description** | |-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Board** | Choose the Scrum board that contains your Agile sprint. Clicking the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_3d378f5f2d22857e68842bc9d766751ba244000b4e7855efaaecd1e349987193/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to the board name will open the selected board in Jira. | | **Sprint** | Choose the sprint for which to display the data. * **Latest sprint (auto)** - select this option if you wantthe most recent sprint that is either closed or active to be used by the gadget. * **Previous sprint (auto) -**select this option if you want the gadget to display the sprint you just completed. When this option is selected, the gadget will always show the sprint immediately before the latest one. * Use these options if you don't want to set the sprint manually all the time. | | **Calculate by** | Specify on which criteria the calculation is to be performed. You can choose between: * **Story Points** - the default value; use this option if the work items are estimated in Story Points. If the work items are from team-managed spaces, select **Story Point Estimate** instead. * **Original Time Estimate** - use this if you use time estimates; the calculation will be done in hours. The **Scope** will be calculated as the sum of the Original Estimate field of all the work items from the sprint, and each time an work item is marked as done, the **Burned** and **Remaining** lines will increase/decrease with the number of hours that are set at Original Estimate for that item. This option does not consider the time spent (work logged). * **Remaining Time Estimate** - select this option if you want to track by Remaining Estimate; the calculation will be done in hours. When this option is selected, the chart displays only the **Remaining** and **Ideal Burndown** lines. The **Remaining** is calculated as the sum of the Remaining Estimate field of all the work items from the sprint, regardless of their status. This option does not consider the time spent (work logged). * **Time Remaining \& Time Spent** - use this option if you use time estimates and your team logs the worked time on a daily basis; the calculation will be done in hours. The **Scope** will be calculated as the sum of the Time Spent and the Time Remaining of all the work items from the sprint. **Burned** is calculated as the sum of Time Spent of all the items from the sprint plus the sum of Time Remaining on all the items from the sprint that are done. **Remaining** is calculated as Scope minus Burned. This option does not consider the Original Estimate field. If you check **Ignore the time logged before the start of the sprint** , the calculation will be based only on the work logged during the sprint. The **Scope** will be calculated as the sum of the Time Spent and the Time Remaining of all the work items at the time when the sprint was started. **Burned** is calculated as the sum of Time Spent of all the items from the sprint plus the sum of Time Remaining on all the items from the sprint that are done. **Remaining** is calculated as Scope minus Burned. This option does not consider the Original Estimate field. The **Ignore the time logged before the start of the sprint** option is available only if **Calculate by** is set to **Time Remaining \& Time Spent**. * **Work Item Count** - use this if you want the calculation to be done by the number of work items. * Other **numerical custom field** defined in your Jira instance - pickup the numerical custom field that you use to track or estimate the work items. | | **Subtasks** | Choose how the gadget should handle subtasks. You can choose between: * **Exclude the subtasks** - the default value; use this option if you don't want the subtasks to be included in the calculation. * **Include the subtasks** - select this option if you want the calculation to include the subtasks along with their parent items. * **Process only the subtasks** - select this option if you want to calculate only the subtasks and ignore all other items. | | **Series to Display** | Choose what series to display in the chart. You can select one or more options: **Ideal Burndown** - the ideal line specific to a burndown chart. It indicates how the remaining work should evolve during the sprint in the ideal case. It is calculated based on Scope (see below). **Ideal Burnup** - the ideal line specific to a burnup chart. It shows how the done (burned) work should evolve during the sprint in the ideal case. It is calculated based on Scope (see below). This option is not available if "Calculate by" is set to "Remaining Time Estimate". **Remaining** - the total amount of remaining work at that time; it is specific to the burndown chart. **Burned** - the total amount of work done at that time; it is specific to the burnup chart. This option is not available if "Calculate by" is set to "Remaining Time Estimate". **Scope** - represents the current sprint goal - the total amount of work to be done in the sprint. Select this if you want to see the changes in the sprint scope over time. This option is not available if "Calculate by" is set to "Remaining Time Estimate". **Tips \& Tricks** To configure the gadget as a "classic" **burndown chart** , select only the **Ideal Burndown** and **Remaining** series. To configure the gadget as a "classic" **burnup chart** , select only the **Ideal Burnup** and **Burned** series. Also, choose how the ideal series will be calculated. By **initial scope** means that the first value of the Ideal Burndown line is the value of the Scope series at the start of the sprint, while by **current scope** means that the first value of the Ideal Burndown line is the current (latest) value of the Scope series. This setting also applies to the Ideal Burnup line. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Sprint burndown burnup configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_730445c61bf36d8507ec8a415de3a349995636f8b6a9e785b3220cd5f3096680/Sprint%20burndown%20burnup%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=ff965e0bfc632097f90fbf96f23ac438) | **Setting** | **Description** | |-----------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **"Done" means** | Specify how the gadget should consider work items as done when determining the work completed. The default option is **Work item is in last column of the selected board**, which means that items are considered done when they reach the last column of the board or, more exactly, a status that is mapped to the last board column. Choose**Work item is in one of these statuses,** and then select one or more workflow statuses, to consider items as done when they reach one of these custom statuses. | | **Show legend** | Check this if you want the chart legend to be displayed. | | **Display the data values at the top of the chart** | Check this option if you want the gadget to display some of the key data values at the top of the chart. When possible, the displayed value also provides a link to open a filter that returns the work items that produced that value. | | **Tilted labels for x-axis (avoid overlapping)** | Check this to avoid overlapping of the x-axis labels. | | **Show data table** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays a sprint report based on the current status, which includes a list of completed and not-completed items. ![Sprint-burndown-burnup---data-table.png](https://documentation.stonikbyte.com/__attachments/a_40c70562903a3ab434911123e6759e0195d46871ac9d66ca0b2dcd329336e433/Sprint-burndown-burnup---data-table.png?cb=2c152b78603db2cc31277358cecc31d2) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | | **Hide weekends** | Check this option if you want the chart not to show weekend days (Saturday and Sunday). | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reloading. This setting is not persistent. | | **Enable scroll zoom** | Check this if you want to be able to zoom-in while scrolling with the mouse wheel over the chart. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Sprint burndown burnup configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_4c2e8ad456e305cf7d2733fdddc03aaabffaa4d92399eba338a79ba64a8e4b68/Sprint%20burndown%20burnup%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=c8c3617796634a6cb1d948c2d05b5e45) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [Tracking an agile project that uses time estimates with Great Gadgets for Jira](https://blog.stonikbyte.com/2021/03/08/tracking-an-agile-project-that-uses-time-estimates-with-great-gadgets-for-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [How to Create a Sprint Burndown in Jira That Includes Sub-Tasks](https://documentation.stonikbyte.com/great-gadgets/how-to-create-a-sprint-burndown-in-jira-that-includes-sub-tasks.md) --- language: "en" --- # Team Velocity Gadget ## Overview This gadget calculates and displays the average velocity of the Agile team along with the history of previous sprints. The calculation can be done by Story Points, Original Time Estimate, Time Remaining \& Time Spent, Work Item Count, or any numerical custom field and it is based on historical data of every work item. You can also choose to include the sub-tasks in the calculation. The team's velocity is an essential metric that helps the Agile teams not to overcommit but also helps them to see how they perform from one sprint to another. ![image-20250701-090937.png](https://documentation.stonikbyte.com/__attachments/a_7846b51cb1ae1f605e5f01bf638e5977726b4a70eeb0d29574671ccd7ec94de2/image-20250701-090937.png?cb=0cefb923d653ec37e86927c19215dab6) **Initial Scope** - Indicates the scope at the start of the sprint (the team commitment). **Final Scope** - Indicates the scope at the end of the sprint, after the eventual scope changes. This helps you determine if your team tends to change the sprint scope and how much. **Completed** - The total amount of work done in that sprint. **Average Velocity** - The (rolling) average velocity calculated as the average of the work done in the last sprints, according to the gadget's settings. Optionally, additional series can be displayed in the chart: **Scope change** - represents the scope change of the sprint, calculated as the difference between Final Scope and Initial Scope. **Scope change absolute** - represents the scope change of the sprint as an absolute value, calculated as the sum of Added and Removed. **Added** - indicates the amount of work added to the scope after the sprint was started. **Removed** - indicates the amount of work removed from the initial scope after the sprint was started. **% Scope Change** - indicates the percent of scope change relative to the Initial Scope. **% Scope Change Absolute** - indicates the percent of scope change absolute relative to the Initial Scope. **% Added** - indicates the percent of work added relative to the Initial Scope. **% Removed** - indicates the percent of work removed relative to the Initial Scope. **% Completed** - indicates the percent of work completed relative to the Initial or Final scope, at your choice. Optionally, in the Data section, this gadget can display a detailed report with advanced statistics for each sprint, which can be easily exported in CSV format. ![Team-Velocity-gadget---data-tab.png](https://documentation.stonikbyte.com/__attachments/a_9dabc41b3e2d1505bf876d8d55e7982710e6adf20122bc9bfa0193f78abb75ad/Team-Velocity-gadget---data-tab.png?cb=7c03f5d4f4bd442e8fcc1c437c7059d3) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **Series** tab - lets you choose what series to display in the chart * **More Settings** tab - contains the optional settings, such as card colors * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Team Velocity gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_592262aef47b219a6d04f3020d7464104bfaf88f4e066e44e97d77977172b356/Team%20Velocity%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=50ccf3c5974b383632f3bcc00bd1f2ac) | **Setting** | **Description** | |--------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Board** | Choose the Scrum board of your team. Clicking the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_f2f6ccaa35e1e2bca09b8a2b6990615a6a5342ab773df07fd2dde6b40089c9e6/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to the board name will open the selected board in Jira. | | **Display the chart for the last ? sprints** | Specify the number of previous sprints to be displayed in the chart, starting from the most recent. | | **Calculate average velocity based on last ? sprints** | Specify the number of previous sprints to be used when calculating the average velocity. Velocity is calculated as the average of the total SPs done in each of these sprints. | | **Calculate by** | Specify on which criteria the calculation to be performed. You can choose between: * **Story Points** - the default value, use this if the work items are estimated in Story Points. If the work items are from team-managed spaces, select **Story Point Estimate** instead. * **Original Time Estimate** - use this if you use time estimates; calculation will be done in hours. * **Time Remaining \& Time Spent** - use this option if you use time estimates and your team logs the worked time on a daily basis; calculation will be done in hours. The **Initial Scope** will be calculated as the sum of the Time Spent and Time Remaining of all the work items at the time when the sprint was started. The **Final Scope** will be calculated as the sum of the Time Spent and Time Remaining of all the work items at the end of the sprint. **Completed** is calculated as the sum of Time Spent of all the work items from the sprint, plus the sum of Time Remaining of all the work items from the sprint that were done. If you check **Ignore the time logged before the start of the sprint**, the calculation will be based only on the work logged during the sprint. The **Ignore the time logged before the start of the sprint** option is available only if **Calculate by** is set to **Time Remaining \& Time Spent**. * **Work Item Count** - use this if you want the calculation to be done by number of work items * Other **numerical custom field** defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the work items. | | **Subtasks** | Choose how the gadget should handle subtasks. You can choose between: * **Exclude the subtasks** - the default value; use this option if you don't want the subtasks to be included in the calculation. * **Include the subtasks** - select this option if you want the calculation to include the subtasks along with their parent items. * **Process only the subtasks** - select this option if you want to calculate only the subtasks and ignore all other items. | ### Series tab On this tab you can choose what series to display in the chart. |-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Series to Display** | Choose what series to display in the chart. You can select one or more options: **Initial Scope** - represents the scope at the start of the sprint (the team commitment). **Final Scope** - represents the scope at the end of the sprint, after the eventual scope changes. This helps you determine if your team tends to change the sprint scope and how much. **Completed** - represents the total amount of work done in that sprint. **Average Velocity** - The average velocity calculated as the average of the work done in the last sprints, according to the gadget settings. **Scope change** - represents the scope change of the sprint, calculated as the difference between Final Scope and Initial Scope. **Scope change absolute** - represents the scope change of the sprint as absolute value, calculated as the sum of Added and Removed. **Added** - indicates the amount of work added to the scope after the sprint was started. **Removed** - indicates the amount of work removed from the scope after the sprint was started. **Unfinished** -- represents the amount of work remaining unfinished at the end of the sprint, calculated as the difference between "Final Scope" and "Completed". **% Scope Change** - indicates the percent of scope change relative to the Initial Scope. **% Scope Change Absolute** - indicates the percent of scope change absolute relative to the Initial Scope. **% Added** - indicates the percent of work added relative to the Initial Scope. **% Removed** - indicates the percent of work removed relative to the Initial Scope. **% Completed** - indicates the percent of work completed relative to the Initial or Final scope, depending on what you selected at **Calculate %Completed relative to ? scope**. **% Unfinished** -- indicates the percentage of unfinished work relative to the "Final Scope". | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Team Velocity gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_e0b47ce48762c25cd188e18d44491559bce07066b2ba452d8e66177317e3d0ae/Team%20Velocity%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=49b5a4decc2e156edac0fbd58195fb7f) | **Setting** | **Description** | |--------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **"Done" means** | Specify how the gadget should consider work items as done when determining the work completed. The default option is **Work item is in last column of the selected board**, which means that work items are considered done when they reach the last column of the board or, more exactly, a status that is mapped to the last board column. Choose**Work item is in one of these statuses,** and then select one or more workflow statuses, to consider work items as done when they reach one of these custom statuses. | | **Options for including sprints** | The gadget displays the closed sprints, but you can choose to include only certain sprints or the active sprints. Check **Only sprints whose names contain...** and enter the text to match if you want only specific sprints to be displayed by the chart. This option is useful when you want to filter out some of the board's sprints. Also, you can check **Only sprints completed between...** and enter the dates of the time interval if you want to display only the sprints that were completed (closed) in that time interval. This option is useful when you want to see the velocity for past sprints. For example, the sprints from the previous year. Check **Include also the active sprint(s)** if you want to display the active sprints (if any) along with the closed sprints. | | **Show legend** | Check this if you want the chart legend to be displayed. | | **Tilted labels for x-axis (avoid overlapping)** | Check this to avoid overlapping of the x-axis labels. | | **Show data table** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays all the sprints along with the work items that affected their velocity. The work items that had zeros on all the columns are not displayed. ![Team-Velocity-gadget---data-tab.png](https://documentation.stonikbyte.com/__attachments/a_9dabc41b3e2d1505bf876d8d55e7982710e6adf20122bc9bfa0193f78abb75ad/Team-Velocity-gadget---data-tab.png?cb=7c03f5d4f4bd442e8fcc1c437c7059d3) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | | **Display all series as lines** | Check this option if you want the chart to have all the series displayed as lines (instead of bars). | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Team Velocity gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_bc99aad4547c02e0375025b13e20cdf32a82bb0471598cc531a68a20b2b385c8/Team%20Velocity%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=99fca0165b00e78847973573945b6c7b) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [Tracking an agile project that uses time estimates with Great Gadgets for Jira](https://blog.stonikbyte.com/2021/03/08/tracking-an-agile-project-that-uses-time-estimates-with-great-gadgets-for-jira/) --- language: "en" --- # Team Wallboard Gadget ## Overview This gadget displays the wallboard with the work items of a specified agile board. It supports both Scrum and Kanban board types of team-managed and company-managed spaces. You can use this gadget to see what your team is working on. ![image-20240618-075340.png](https://documentation.stonikbyte.com/__attachments/a_71f4a9d0dfc1cdea5eb9f4703aa7420597384112c62f77a0e6544ca6d198a9ae/image-20240618-075340.png?cb=034093df54b2a4a08d362f6ea6b38506) It shows the work items with their key, summary, assignee, priority, and current estimate. It can also display sub-tasks and epics. Optionally, you can apply one or more of the board's quick filters or to display swim-lanes by various criteria. ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title and data source * **More Settings** tab - contains the optional settings, such as card colors ### Data tab On this tab you can configure the required settings of the gadget. ![Team Wallboard chart gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_cdc3e0c1cbfb45b159535fa7f4f205062d0498b8401e22814b68fd774e4e17dc/Team%20Wallboard%20chart%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=4edd2ae19263cacc7c51ca66625cfac7) | **Setting** | **Description** | |----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Gadget title** | Choose what to display in the title bar of the gadget. | | **Data source** | Select the agile board to be displayed. The gadget displays only the work items from the selected board that are visible to the current Jira user. You can also select a filter or a JQL as the data source. In this case the gadget will display the work items in the form of a Kanban board having them grouped in 3 columns by their status categories: *To Do* , *In Progress* and *Done*. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_2c9664927285aa6411d2ecd5d7fe8109535c9e33b9d61914bb898b7a821554d8/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Sprint** | Choose what sprint to display on the wallboard. If **Active sprint(s)** is selected, the gadget will display the work items of the active sprint; if the board has multiple active sprints, all the work items from these sprints are displayed. This option applies only to the Scrum boards. | | **Quick filters** | Choose to apply one or more quick filters of the selected board, for limiting the items displayed. This option is only available for the Cloud version. | | **Estimation field** | Choose the field that contains the work item estimate or "None" if you don't want the estimate to be displayed. | | **Swimlanes** | Choose if the gadget should display swim-lanes or not. A swim-lane is a horizontal categorization of work items on the board. You can use swim-lanes to help you distinguish tasks of different assignee, epics, priorities, etc. This option is only available for the Cloud version. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Team Wallboard chart gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_b50a55e91fa1958ed3f50ce32787808ca9e356394ba7610e716f1fd7de7d5806/Team%20Wallboard%20chart%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=6fd0d5a71a6209c98a904f5af09a503b) | **Setting** | **Description** | |----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------| | **Show sub-tasks** | Check this if you want the sub-tasks to be also displayed on the wallboard. | | **Show sprint info** | Check this if you want to display the sprint name along with the sprint timeline. | | **Use compact-size cards** | Check this if you want to display the cards with a smaller size. | | **Cards color** | Customize the color of the cards. You can pick a color for each work item hierarchy level (Epics \> Stories, tasks, bugs \> Sub-Tasks). | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [9 gadgets for a powerful Scrum dashboard in Jira](https://blog.stonikbyte.com/2020/07/28/7-gadgets-for-a-powerful-scrum-dashboard-in-jira/) * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://wordpress.com/post/blog.stonikbyte.com/104) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) --- language: "en" --- # Technical Notes ## Rate limits Great Gadgets is a reporting application that, by definition, works with a large amount of data, so it makes a considerable amount of calls to Jira to retrieve the necessary data. We recommend that you do not enable user rate limits in the Jira or Confluence environment where Great Gadgets is running, as this may slow down the performance of the gadgets in terms of load time and negatively affect the user experience. But if you still want to set rate limits, note that Great Gadgets recognizes the specific error code thrown by Jira or Confluence when a rate limit is reached and, instead of getting an error outright, will retry up to 30 times at intervals of at least 1 second. If it still fails after these attempts, an error message will be displayed. So make sure you don't set the limit too low. ## IP Allowlisting If you want to use [IP allowlists](https://support.atlassian.com/security-and-access-policies/docs/specify-ip-addresses-for-product-access/) at the organisation level, to specify which IP addresses users must use to access content in Jira, please add the following IPs to your allowlists in order to allow Great Gadgets to communicate with Jira instance: * 52.31.157.191 * 54.73.245.52 * 54.217.10.114 * 99.80.197.69 * 18.144.121.71 * 54.177.13.219 * 54.177.25.33 * 54.193.97.22 If these IPs are not added, the gadgets will return an error *403 (Forbidden)*: ![image-20250802-165249.png](https://documentation.stonikbyte.com/__attachments/a_73f8f80ea20f4e814d3bbeade9448cdcf03e29f71dbc833f1e8816535e0e53da/6f165d56-4ec7-4f4a-bb23-cf425f904dc4%23media-blob-url=true&id=097e85c3-de2f-4437-b449-4e6f36a228de&contextId=21538&collection=?cb=5cae66970a2fad3e0457b96307655fcb) Also, if users of Great Gadgets are behind a proxy or firewall, make sure it is configured to allow HTTPS traffic to the domain `cloud.stonikbyte.com`. ## Additional settings for using macros in Confluence Data Center with SSO enabled On Confluence Data Center with Single Sign-On (SSO), most of the app gadgets imported from Jira as external gadgets cannot be used in Confluence pages due to an error (401 - Unauthorized). ![https://bitbucket.org/repo/8xRkK4/images/2386305146-image.png](https://bitbucket.org/repo/8xRkK4/images/2386305146-image.png) This happens when Jira is configured to use `SSOSeraphAuthenticator`, which means that in the *seraph-config.xml* file located in Jira's *WEB-INF/classes* directory has this line uncommented: ‌ The Jira log file contains errors like this: 2022-08-18 11:43:27,047+0200 pool-task-service-1-thread-13 ERROR W92326 703x120394x1 8ifbei 172.23.254.214,172.23.254.11 /plugins/servlet/stonikbyte/greatgadgets/aws [c.s.c.b.services.tasks.Task] Error executing task with key: http://127.0.0.1:8080AgileBoards : Received http error code 401. Access to /rest/agile/1.0/board is not authorized. The id of this error is: 1382949090049972 com.stonikbyte.connect.base.rest.client.exceptions.HttpRequestUnauthorizedException: Received http error code 401. Access to /rest/agile/1.0/board is not authorized. The id of this error is: 1382949090049972 at com.stonikbyte.connect.base.rest.client.BaseJiraRestServiceProvider.evaluateResponse(BaseJiraRestServiceProvider.java:180) at com.stonikbyte.connect.base.rest.client.BaseJiraRestServiceProvider.checkHttpResponseCode(BaseJiraRestServiceProvider.java:334) at com.stonikbyte.connect.server.rest.client.JiraServerRestServiceProvider.readServiceResponse(JiraServerRestServiceProvider.java:252) at com.stonikbyte.connect.server.rest.client.JiraServerRestServiceProvider.readPaginatedResponseInternal(JiraServerRestServiceProvider.java:115) at com.stonikbyte.connect.server.rest.client.JiraServerRestServiceProvider.readPaginatedResponse(JiraServerRestServiceProvider.java:58) at com.stonikbyte.great.gadgets.common.services.impl.JiraRestServiceImpl.getAllAgileBoards(JiraRestServiceImpl.java:1284) at com.stonikbyte.great.gadgets.common.tasks.TaskGetAllAgileBoards.execute(TaskGetAllAgileBoards.java:36) at com.stonikbyte.connect.base.services.tasks.Task.run(Task.java:203) at com.stonikbyte.connect.base.services.tasks.ManagedExecutorService$MonitoredTask.run(ManagedExecutorService.java:198) at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) at java.base/java.util.concurrent.FutureTask.run(Unknown Source) at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) at java.base/java.lang.Thread.run(Unknown Source) These errors occur due to the fact that the gadgets fail to connect to Jira for retrieving the necessary data. This happens because the SSO specific info is not passes to Jira along with the request made by Confluence. The solution is to configure Jira to use `JiraSeraphAuthenticator` instead of `SSOSeraphAuthenticator`. Based on our tests, this change fixes the error and the user logon is not impacted. This can be done by editing the *seraph-config.xml* file from Jira's *WEB-INF/classes* directory. First, comment this line... ... then, uncomment this line Save the file. Repeat this on all Jira nodes. ## Search results limit when OpenSearch is enabled in Jira Data Center By default, Jira data Center uses the built-in Lucene search engine for indexing and queries. Starting with newer versions (11.2+), OpenSearch is available as an optional feature, but it must be explicitly configured and connected to an external OpenSearch cluster. If OpenSearch is enabled in your Jira Data Center instance, be aware that it introduces a maximum limit on search result retrieval. By default, this limit is set to 10,000 items. You can check the current value in **Jira Administration** \>**System Info** , under the `jira.search.platform.max.result.window` parameter. ![image-20260331-083337.png](https://documentation.stonikbyte.com/__attachments/a_58eddfce3130d3a27483bee3195689bf8f1f362b8074a1dee851dc37ebca1e37/image-20260331-083337.png?cb=9e12862dbe9fc41eb348a3e83c365b05) This limit can impact the functionality of app gadgets if they are configured with a data source that returns more than 10,000 Jira work items. In such cases, an error like the following may be displayed: ![image-20260331-084315.png](https://documentation.stonikbyte.com/__attachments/a_79d5fd75807a853d5e4b2347704c20b673e84c77373237bbc13aed105b5c256c/image-20260331-084315.png?cb=d80ef67ab378c98416a52e39a5ec2ab0) To resolve this error, increase the value of the `jira.search.platform.max.result.window` parameter to a higher limit. --- language: "en" --- # Time in Status Gadget ## Overview This gadget indicates how long work items stayed in each workflow status, status category, or board column. You can choose to show total time or average time, or group the data by different criteria, such as assignee, project, or priority. The displayed result can be in the form of pie chart, bar chart column chart or staked column chart, as per your choice. This gadget is especially useful for identifying workflow bottlenecks, understanding team performance, and ensuring projects stay on schedule. ![image-20240726-050023.png](https://documentation.stonikbyte.com/__attachments/a_754fdfc5624331d30d5c5c4a19b51f0caa70b30293172dd383d4d2aa76b6e1c0/image-20240726-050023.png?cb=265085c0977883c43a28932e008eacca) Time in Status as Stacked Column Chart ![image-20240726-050051.png](https://documentation.stonikbyte.com/__attachments/a_c1f5b45eb12b93e15d46a797a0649528fbf2e13fe00e7e60c22d55bcbac186ad/image-20240726-050051.png?cb=000cb58c682dec0a595993e397619ec0) Time in Status as Pie Chart ![image-20240726-050558.png](https://documentation.stonikbyte.com/__attachments/a_39f3e071f7df177d0737f0a009589b7a33eff736d4e293e69a720ba859c42e8d/image-20240726-050558.png?cb=75b62e10ae3a3facf9ddc74ac694279a) Time in Status as Bar Chart ![image-20240726-050724.png](https://documentation.stonikbyte.com/__attachments/a_185f2aebe13bbb4f817aae43dfa08991979d87cbde23d01ded59c98046d84711/image-20240726-050724.png?cb=ccb8eccc71981a6cef9e4129ea7cdf9d) Time in Status as Column Chart ![image-20240726-045748.png](https://documentation.stonikbyte.com/__attachments/a_a71f8b99ebb633aafb6d3cfa6a63f8d34b177723cfa86c298e292fb888b626a0/image-20240726-045748.png?cb=8c08fccc39bd7d2b62bbf09c6da7d59e) Time in Status split by Assignee as Stacked Column Chart ![image-20240726-051037.png](https://documentation.stonikbyte.com/__attachments/a_f438407867c7d896467cb0e7dbbda94a6162e5f435ec584cac89d5d3bd97af30/image-20240726-051037.png?cb=deb7f5588546b13eb0b492b437aa44b9) Time in Status split by Priority as Stacked Bar Chart The gadget can display a Data tab with detailed information about each work item and the time in the statuses reached during their life-cycle, which you can easily export in CSV format. ![Time-in-status-gadget---data-table.png](https://documentation.stonikbyte.com/__attachments/a_aba9d4231ddf3dff1050fee168810fa26a72a7a2ebf744b56484b5db60adb00b/Time-in-status-gadget---data-table.png?cb=6b73a466ccdf548fffa209b1521a8af6) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![Time in status gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_67d0a4d7d03c1306d408fa088ef74c933ac2d1f453312cbeac23094fb375d147/Time%20in%20status%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=bf92d433619e3e8b2b5b1cdfe4d77054) | **Setting** | **Description** | |-------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data Source** used by the gadget: * The agile**Board** of your team. * A**Saved filter** that returns the work items you want to be processed by the gadget. Make sure that the specified filter is shared with the users who will also visualize this gadget. * A **JQL** query that returns the work items you want to be processed by the gadget. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_fa4e864f2465ca23187fd0b2cb397d5c3244d28232de143ee4b20b6ac613da52/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Count also the sub-tasks and their estimate** | Check this option if you want the gadget to consider the sub-tasks from the selected board, filter or the specified JQL. | | **What to measure** | Choose what you want the gadget to measure. You can chose between: * **Time in status** - By selecting this option the gadget will calculate the time in every workflow status that work items reached during their life-cycle. * **Time in status category** - By selecting this option the gadget will calculate the time the work items stayed in every status category: *To Do* , *In progress* or *Done.* * **Time in columns of the selected board** - By selecting this option the gadget will calculate the time the work items stayed in every column of the selected board. This option can only be used with a **Data source** of type *Board*. | | **Calculation method** | Indicates how calculate the time. You can choose between: * **Total time** - By selecting this option the gadget will calculate and display the time in status, category or board column by summing-up the time spent on all the work items * **Average time** - By selecting this option the gadget will calculate and display the time in status, category or board column as the average duration by dividing the total duration to the number of work items | | **Group data by** | Optionally, you can choose to group the data by an work item field, such as Assignee, Work Item Type, or Priority, of your choice. | | **Chart type** | The type of the chart to be displayed by the gadget. If **Group data by** is set to *None* , you can choose from *Column chart* , *Bar chart* , *Pie chart* , or *Stacked column chart* . Otherwise, you can choose either *Stacked column* or *Stacked bar*. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Time in status gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_06647cf69dd8d8aacebbcfa02d51135ddc31cf8260778142295c78f2281bd52c/Time%20in%20status%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=067ca5fe1e8e2f624f4fb8368dcf3391) | **Setting** | **Description** | |-------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Statuses to process** | Specify what statuses to be processed. You can choose one of the following options: * **Only statuses in these categories** - The default option. If selected, the gadget will only process statuses from the selected status categories. By default, only the *To Do* and *In Progress* categories are selected; the *Done* category is intentionally excluded because work items in this status category will most likely remain in their current done-category status and the time in that status will continually increase, thus not being relevant for the analysis. * **All statuses except these** - By selecting this option the gadget will process all statuses reached by the work items except those specified. This option is useful if you want to exclude certain statuses from the analysis. * **Only these statuses** - By selecting this option the gadget will process only the specified statuses. * **All the statuses** - By selecting this option the gadget will process all all statuses reached by the work items. | | **Calculate in** | Specify in what time unit measure the results will be displayed. | | **Don't count weekends** | Check this option if you want to exclude the weekends (Saturdays and Sundays) when calculating the time in status. | | **Show legend** | Check this option if you want the chart legend to be displayed. | | **Show data table** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays the work items along with time in every status, status category or column of board depending on what you selected at **What to measure** on Data tab. Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | | **Display statuses in this custom order** | Choose the order in which you want the statuses to appear. This lets you control how they are displayed in the gadget. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![Time in status gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_309982c4e66f8c0ca0e6c650a030162634978a6eea82a84e9a7d480b79cb0a08/Time%20in%20status%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=6f681f6d2a5b420f064e870677b7eeba) | **Setting** | **Description** | |---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. By default, only the common series are listed, but you can use the **Add** (+) button to add additional series to the table. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://wordpress.com/post/blog.stonikbyte.com/104) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [7 Essential Team Performance Metrics To Track In Jira By Using Great Gadgets App](https://blog.stonikbyte.com/2025/08/14/essential-team-performance-metrics-to-track-in-jira-by-using-great-gadgets-app/) --- language: "en" --- # Use Cases * [How to Create a Sprint Burndown in Jira That Includes Sub-Tasks](https://documentation.stonikbyte.com/great-gadgets/how-to-create-a-sprint-burndown-in-jira-that-includes-sub-tasks.md) * [How to Visualize Linked Issues and Their Status in Jira Dashboards](https://documentation.stonikbyte.com/great-gadgets/how-to-visualize-linked-issues-and-their-status-in-jira-dashboards.md) * [How to Track Total or Average Time In Status in Jira Dashboards](https://documentation.stonikbyte.com/great-gadgets/how-to-track-total-or-average-time-in-status-in-jira-dashboards.md) --- language: "en" --- # What is Great Gadgets? Great Gadgets is an app for Jira and Confluence that provides a set of Jira dashboard gadgets and Confluence macros for tracking projects in an efficient and effective manner. You can use them to enhance your Jira dashboards or Confluence pages with agile charts, reports, and KPIs. The app is developed by [StonikByte](https://stonikbyte.com/) - an Atlassian Platinum Marketplace Partner - and is compatible with Jira Cloud, Jira Data Center, and Confluence Cloud, and is available on the Atlassian Marketplace in three different listings: **Jira Cloud** ![image-20240406-140034.png](https://documentation.stonikbyte.com/__attachments/a_31b9ffb6e1a60f883adfa70a40c01d589aea572cf50e26a3c972aa262e09ae73/image-20240406-140034.png?cb=600ce06f260c2cb0ec1967b7524eef41) Built on the **Atlassian Forge** platform. **Jira Data Center** ![image-20240406-140121.png](https://documentation.stonikbyte.com/__attachments/a_1e151e16fdf2a6a268e7e17951d59c7395bdc4449aa140ec86cc93da42517bd4/image-20240406-140121.png?cb=ee7b506c40b7ce50dfdb0da7ebca81c4) Its gadgets can be imported and used in Confluence Data Center. **Confluence Cloud** ![image-20240406-140201.png](https://documentation.stonikbyte.com/__attachments/a_821fd8dcbd7d34c7b9dfbdf4772ad88b647be7168bf01c195c858a5c0afd81a9/image-20240406-140201.png?cb=f103ca2c52560173e83ebb6f3ac0c4de) Built on the **Atlassian Forge** platform. The app is compatible with Jira Service Management (JSM) and Jira Work Management. --- language: "en" --- # WIP Aging Chart Gadget ## Overview Depending on how you configure it, this gadget displays the "work-in-progress" (WIP) work items from a filter or an agile board in a scatter plot chart by their time (age) in their status or board column. Optionally, the chart can display percentiles or the average line. Also, a custom threshold line can be added for easily identifying the work items that have an age (time in status or time in column) higher than expected. You can use this gadget to easily identify the work items that stay longer than expected in a specific workflow status or board column. Hovering the mouse pointer over an work item in the chart will display a tooltip with the work item details, like the work item summary or age. If configured to display the columns of an agile board, the gadget also displays the WIP limits of the boards and highlights them accordingly when these limits are exceeded. ![WIP-aging-chart-gadget.png](https://documentation.stonikbyte.com/__attachments/a_f77c6b3deb3274cc973a407f511528be34abd5d1e5ca4f502d17db5575c1fb3a/WIP-aging-chart-gadget.png?cb=c8735150604c824dd5ac32d222a15349) The age calculation method is configurable. The gadget can display a Data tab with more details about every work item displayed in the chart. See the settings description below for how to configure the gadget. ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![WIP aging chart gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_dcf4fb8d2c7abb740da7805d72aa7a119ce48be088f8501eec9cfe85719f2489/WIP%20aging%20chart%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=6850e7d99e6b21a1cb682f6a80ef9bf6) | **Setting** | **Description** | |----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data Source** | Select the type of **Data Source** used by the gadget: * Theagile**Board** of your team. * A**Saved filter** containing the work items that you want to track in the chart. Make sure that the specified filter is shared with the users who will also visualize this gadget. Check **Include the sub-tasks** if you want the sub-tasks from the selected board, filter or JQL to be included in the calculation. Also, check **Include the work items from the "To Do" category** if you want the "To Do" work items to be displayed along with the "In Progress" work items. * A **JQL** query that returns the work items you want to be processed by the gadget. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** - Select one or more work items above the Epic level, such as Initiatives or Themes. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_316646d42a6fc185e6a09200d32f11b3ed7573a2681dd629dfed7c3b48a65767/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Display chart by** | It indicates what the chart displays on its horizontal axis and how the work items are grouped in the chart. **The statuses of the work items** makes the horizontal axis display the statuses of the work items. If **Data** has a **Board** selected, the horizontal axis of the chart displays the workflow statuses mapped on the "in-progress" columns of the selected board. If **Data** has a **Filter** selected, the horizontal axis of the chart displays the "in-progress" category statuses of the work items from the selected filter. **The columns of the selected board** makes the chart display on its horizontal axis the "in-progress" columns of the selected board along with their work items. | | **Age calculation method** | Specify how the age is calculated by choosing one of these options: * **Time since last entry in current status or board column** - the age is the time since the last entry in its current status (if the chart is displayed by **The statuses of the work items** ) or the time since the last entry the current board column (if the chart is displayed by **The columns of the selected board**). The previous occurrences are not counted. * **Sum-up the duration of all the occurrences in current status or board column** - the age is the total time spent in its current status (if the chart is displayed by **The statuses of the work items** ) or the total time spent in its current board column (if the chart is displayed by **The columns of the selected board**). The previous occurrences are counted. * **Sum-up the duration of all the occurrences in the category of its current status or board column** - the age is the total time spent in the category (*To Do* , *In progress* or *Done* ) of its current status (if the chart is displayed by **The statuses of the work items** ) or of its current board column (if the chart is displayed by **The columns of the selected board**). The previous occurrences in the status/board columns from the same category as the category of its current status/board column are all counted. * **The time since the first occurrence in the category of its current status or board column** - the age is the total time since the moment when the work item reached the category (*To Do* , *In progress* or *Done* ) of its current status (if the chart is displayed by **The statuses of the work items** ) or of its current board column (if the chart is displayed by **The columns of the selected board**). * **The time since the work item creation -**the age is the total time from when the work item was created to now. | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![WIP aging chart gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_32e1293c1995ac9384268bb518470b356820c31c386b89edde45a0159efc8039/WIP%20aging%20chart%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=176f8ec6e428f7e6a650b983d7b63e92) | **Setting** | **Description** | |-------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Calculate age in** | Specify in what time unit measure the age of the work items will be displayed. | | **Don't count weekends** | Check this option if you want to exclude the weekends (Saturdays and Sundays) from the age calculation. | | **Display average line** | Check this option if you want the chart to display a line with the average age for all the work items displayed in the chart. | | **Display threshold line** | Check this option if you want the chart to display a line representing a threshold. The work items that have an age higher than the specified **Threshold** value will be colored in red. | | **Display percentile lines** | Check this option and enter the values (percents) corresponding to the percentiles to be displayed. A percentile is a value from the data set that splits the data into two pieces: the lower piece contains the percent of the data, and the upper piece contains the rest of the data. For example, the 75% percentile will be displayed as a horizontal line with 75% of the work items under it and the rest of the work items (25%) over it. | | **Use logarithmic scale for the vertical axis** | Check this option if you want the chart to display a logarithmic scale instead of a linear scale for the Y axis. | | **Show legend** | Check this option if you want the chart legend to be displayed. | | **Show data table** | Check this option if you want a data table to be displayed along with the chart. The **Data** tab displays the work items grouped by status or board column along with their time spent (age) in their current status or board column for all their occurrences in that status or column. ![WIP-Aging-chart---data-table.png](https://documentation.stonikbyte.com/__attachments/a_d773a616dd07a791f50463c78ae6a0141be20dc5a180b5f3150a399c6e5cfb4c/WIP-Aging-chart---data-table.png?cb=78a6699fc7c2a01c3839fba76b8aace9) Choose how the data table is displayed in the gadget: * **Show data table on a separate tab** -- displays the data table on a dedicated tab, separate from the chart. * **Show data table below the chart** -- displays the data table directly below the chart, allowing you to view the chart and its underlying data together. | | **Open data tab first** | Check this option if you want the gadget to open on the Data tab first (instead of Chart tab as default). Note that the tab order will remain unchanged (Chart, then Data); only the initial view will switch to the Data tab. | | **Display statuses in this custom order** | Choose the order in which you want the statuses to appear. This lets you control how they are displayed in the gadget. | | **Tilted labels for x-axis** | Check this option to avoid overlapping labels on the x-axis. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![WIP aging chart gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_a343d1ae2f3ce68f071ad0f0f41503b0c8b548e63ecb846de641720929af80ac/WIP%20aging%20chart%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=3d5be515072867a8f4340cc99d671241) | **Setting** | **Description** | |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) * [SLA Breaches in Jira: What they are, why they happen and how to track and prevent them using Great Gadgets for Jira](https://blog.stonikbyte.com/2025/06/20/sla-breaches-in-jira-what-they-are-why-they-happen-and-how-to-track-and-prevent-them-using-great-gadgets-for-jira/) --- language: "en" --- # WIP Run Chart Gadget ## Overview The WIP Run Chart is a type of chart that shows the amount of work in progress (WIP) over time for a team or a process. WIP is the number of items that have been started but not yet finished, or their total estimate, such as the sum of story points. A WIP Run Chart can help you find trends or patterns in your work process, such as bottlenecks, fluctuations, or improvements. It can also help you monitor and control the WIP level, which is an important aspect of Kanban and other agile frameworks. ![image-20251016-103317.png](https://documentation.stonikbyte.com/__attachments/a_4b60c50eb885973eebde19415b64b5cb2112d07b54d507a92f30e9c62d7b510d/image-20251016-103317.png?cb=23b6f2d4550a8a1e7ede8312003109e8) The WIP Run Chart has two axes: the x-axis represents the timeline, and the y-axis represents the WIP count. Each data point on the chart shows the total WIP for a given day or period. The chart can also display a trend line, which can help you identify the direction and rate of change of your WIP level. See the settings description below for how to configure the gadget. ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors** tab - lets you customize the color of the lines displayed in the chart ### Data tab On this tab you can configure the required settings of the gadget. ![WIP run chart gadget configuration in Jira - data tab.png](https://documentation.stonikbyte.com/__attachments/a_7e32d46598b3a985cfba0fd0377c4c08fff9df2135c4a74e815dcf2720fbf664/WIP%20run%20chart%20gadget%20configuration%20in%20Jira%20-%20data%20tab.png?cb=c8257afe33575bf80017dc9b284b3722) | **Setting** | **Description** | |-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data source** | Select the type of **Data source** used by the gadget: * Theagile**Board** of your team. * A **Saved filter** that contains the work items that you want to track in the chart, make sure that the filter is shared with a Jira project or My Organization. Check **Include the sub-tasks** if you want the sub-tasks from the selected board, filter or JQL to be included in the calculation. * A **JQL** query that returns the work items you want to be processed by the gadget. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** - Select one or more work items above the Epic level, such as Initiatives or Themes. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_6c396cbffe710fd98cbaf2203ddaf8d42f6c6bf4751b86ce0b56df69b81d2103/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Time interval** | Represents the time interval displayed by the gadget. You can choose from multiple options: * **Custom dates** - choose this option if you want to manually enter a *Start date* and an *End date*. * **A number of days back** - By choosing this option, the gadget will use a rolling time interval with a number of days back to the current day. * **Dates of a project release** - Choose this option if you want the gadget to use the start and end dates of an existing space release (added on the Releases page of a Jira space). Make sure the selected release has a *Start date* and *End date* set. Any subsequent changes to the release dates made on the space's Releases page will be automatically reflected in the gadget, without the need to reconfigure it. * **Dates of a sprint** - Choose this option if you want the gadget to use the start and end dates of an existing sprint. Only the dates are considered (not also the hours). The start of the interval will be the start date of the sprint with time at the start of day, while the end of the interval will be the end date of the sprint with the time at the end of day. When enabled, you'll need to select the board the sprint belongs to. If you choose the *Latest sprint (auto)* , the date range will automatically match the most recent sprint. If you choose the *Previous sprint (auto)*, the date range will automatically match the sprint immediately before the latest one. If you manually select a specific sprint, any changes made to its dates on the board will be automatically reflected in the gadget, without the need to reconfigure it. Be aware that you can also check the **Continue to display data after end date** option in the **More Settings** tab if you want the chart to still display data even if the end date has passed. | | **Intervals of** | Indicates the length of the intervals displayed on the horizontal axis. | | **Calculate by** | Specify on which criteria the calculation is to be performed. You can choose between: * **Story Points** - the default value; use this option if the work items are estimated in Story Points. If the work items are from team-managed spaces, select **Story Point Estimate** instead. * **Original Time Estimate** - use this if you use time estimates; the calculation will be done in hours. * **Work Item Count** - use this if you want the calculation to be done by the number of work items. * Other **numerical custom field** defined in your Jira instance - pickup the numerical custom field that you use to track or estimate the work items. | | **"WIP" means** | Specify how to consider the work item as being work-in-progress (WIP). | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![WIP run chart gadget configuration in Jira - more settings tab.png](https://documentation.stonikbyte.com/__attachments/a_7200da030e19efee579a26a23a439bdf39035bcb5cbd8644ce9cde8f3679c321/WIP%20run%20chart%20gadget%20configuration%20in%20Jira%20-%20more%20settings%20tab.png?cb=2b70083f8930a54e66422a4d2904fe9c) | **Setting** | **Description** | |---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Total WIP** | Check this option if you want the chart to display the "Total WIP" line representing the overall work volume across the selected time interval. | | **Trendline** | Check this option to display a line on the chart that reveals the overall direction of the data. The trendline can be: * *Linear* - a best-fit straight line that shows if the average cycle time is increasing or decreasing at a steady rate. * *Polynomial* - is a curved line, determined based on an order 2 polynomial formula, which is recommended when the data fluctuates. | | **Split WIP by** | Check this option if you want the chart to split the WIP by a chosen field, showing a separate line for each value of that field. | | **Maximum WIP limit** | Check this option if you want the chart to display a horizontal line representing a maximum limit. The work items that have exceeded this limit and are above the horizontal line will be highlighted in red, and will be included in the WIP Breaches count displayed at the top of the chart. | | **Minimum WIP limit** | Check this option if you want the chart to display a horizontal line representing a minimum limit. The work items that have not met this limit and are below the horizontal line will be highlighted in red, and will be included in the WIP Breaches count displayed at the top of the chart. | | **Show legend** | Check this option if you want the chart legend to be displayed. | | **Display point values** | Check this option if you want the numeric values of each data point to be displayed on the chart. | | **Continue to display data after end date** | Check this option if you want the chart to still display data even if the end date passed. | | **The vertical axis always starts at 0** | Check this option if you want the vertical axis to always start at zero. If unchecked, the chart will automatically determine the minimum value of the vertical axis for optimal visibility. | | **Display horizontal gridlines** | Check this option if you want the chart to display gridlines for the vertical axis. | | **Enable scroll zoom** | Check this if you want to be able to zoom-in while scrolling with the mouse wheel over the chart. | | **Refresh cached data at next display** | This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent. | ### Colors tab On this tab you can customize the color of the lines displayed in the chart. ![WIP run chart gadget configuration in Jira - colors tab.png](https://documentation.stonikbyte.com/__attachments/a_deb30d15f982069684d35c113375fe0057a86b77b01c07cbfbbdfb037134319a/WIP%20run%20chart%20gadget%20configuration%20in%20Jira%20-%20colors%20tab.png?cb=745caa6935a2066df4d2cf992ebb564a) | **Setting** | **Description** | |---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Automatically assign colors** | Check this if you want the chart to automatically assign colors for the series. | | **Custom colors** | Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color. By default, only the common series are listed, but you can use the **Add** (+) button to add additional series to the table. You can also use the **Copy** and **Import** buttons to copy and import the color configuration to gadgets of the same type. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * [13 "must-have" gadgets for any Kanban dashboard in Jira](https://blog.stonikbyte.com/2020/09/18/six-must-have-gadgets-for-any-kanban-dashboard-in-jira/) * [How to track multi-team or scaled-agile projects (such as SAFe®) in Jira with Great Gadgets app](https://blog.stonikbyte.com/2022/02/01/how-to-track-scaled-agile-projects-in-jira-with-great-gadgets-app/) * [An effective dashboard for Service Desk and Customer Support teams in Jira Service Management](https://blog.stonikbyte.com/2023/05/15/an-effective-dashboard-for-service-desk-and-customer-support-teams-in-jira-service-management/) --- language: "en" --- # Work Breakdown Structure (WBS) Gadget ## Overview This gadget offers the Work Breakdown Structure (WBS) diagram in form of Initiatives \> Epic \> Parent Tasks \> Sub-Tasks for the work items from a Jira Saved filter or a JQL. The initiatives are those work items defined in Atlassian's Advanced Roadmap app (formerly Jira Portfolio) that are superior to epics in the work items hierarchy. With this gadget, you can see the high-level status of your epics or the entire project. The work items displayed are ordered according to the ORDER BY clause of the filter used. ![WBS - hierarchy view in Jira.png](https://documentation.stonikbyte.com/__attachments/a_cf403b5c5e163a0053046d2dd3ce1bd77f5f8a031146fade504d47da10be468e/WBS%20-%20hierarchy%20view%20in%20Jira.png?cb=e50aae52cd8074026fd37c0441c893db) Additionally, the Work Breakdown Structure (WBS) gadget can display work items together with their linked work items and their status, providing a more complete view of how related work items connect and progress. ![WBS - linked issues view in Jira.png](https://documentation.stonikbyte.com/__attachments/a_88259610da8715c457158606da8338f603cfd1e8ca3ff8fceb4d904b801695e0/WBS%20-%20linked%20issues%20view%20in%20Jira.png?cb=ba281acc0bd06303f43e66d3f1239542) The gadget can also display work items in a structured table format with customizable columns. This gives flexibility to choose which fields to display, making it easier to analyze and review work items in a detailed, tabular layout. ![WBS---Table-view.png](https://documentation.stonikbyte.com/__attachments/a_bed92c7acb874ba7253e04cf0bcb4a0fb408b7d1c0a5a829afa62cd47aa966f7/WBS---Table-view.png?cb=2387afd519fae4ad134539448777a777) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings ### Data tab On this tab you can configure the required settings of the gadget. ![WBS Gadget.png](https://documentation.stonikbyte.com/__attachments/a_3b0f45bc8c195657a67fbfddb21e79482da13982ccc6cd039a6799fb2433e745/WBS%20Gadget.png?cb=d591135d25e344d8abe3aca47751794c) | **Setting** | **Description** | |------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Visualization mode** | Specify the type of **Visualization mode** used by the gadget. You can choose between: * **Hierarchy View** - the default option; select this option if you want the work items displayed in a parent-child structure (Epics \> Stories/Tasks \> Subtasks) along with their status. If you have additional work item levels above *Epics* , such as *Initiatives* or *Themes*, they will also be displayed in the hierarchy. For an work item to appear in the hierarchy, it must be returned by the filter/JQL configured in the Data Source. * **Linked Work Items View** - select this option if you want to display work items together with their linked work items and their status. See [How to Visualize Linked Issues and Their Status in Jira Dashboards](https://documentation.stonikbyte.com/great-gadgets/how-to-visualize-linked-issues-and-their-status-in-jira-dashboards.md) It is not required for linked work items to be returned by the filter/JQL configured in the Data Source in order for them to be displayed. | | **Data Source** | Select the type of **Data Source** used by the gadget: * A**Saved filter** containing the Jira work items that you want to display. Make sure that the specified filter is shared if you want other people to visualize the dashboard. * A **JQL** query that returns the work items you want to be displayed by the gadget. * A **Sprint** selected from a board. The gadget will include only the work items that belong to the selected sprint of the specified board. You can select: * **Latest sprint (auto)** - select this option if you wantthe most recent sprint that is either closed or active to be used by the gadget. * **Previous sprint (auto) -**select this option if you want the gadget to display the penultimate sprint. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** - Select one or more work items above the Epic level, such as Initiatives or Themes. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_0f71e2396c215796a81fe896f8567ad6466eee41ed483da419dcf1215569a688/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Expand** | Specify how many levels to be expanded by default right after displaying the gadget. | | **Status Category** | Specify which status categories the displayed work items should belong to, based on their current status. * **To Do**- Check this option to display those work items that have their current status in the "To Do" category. This includes the gray-colored statuses, like "New", "To Do", or "Open". * **In Progress** - Check this option to display those work items that have their current status in the "In Progress" category. This includes the blue-colored statuses like "In Progress", "Working", or "In Testing". * **Done** - Check this option to display those work items that have their current status in the "Done" category. This includes the green-colored statuses like "Done", "Closed", or "Resolved". | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![WBS - More settings.png](https://documentation.stonikbyte.com/__attachments/a_16b2e981aafcaeb1dd75ef0c0e18966559d5f181f99bb0783cf1f93e220267a0/WBS%20-%20More%20settings.png?cb=feee6ff3f35539af0bb94080899c3046) | **Setting** | **Description** | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Display mode** | Select how you want the work items to be displayed by the gadget: * **Tree view** - the default option; select this option if you want all the link types to be displayed in a compact tree view with key, summary, and status. * **Table with custom columns** - select this option if you want the gadget to display the work items in a table with custom columns. When **Table with custom columns** is selected, you can enter the columns to be displayed in the **Select column to add** section. | | **Link types to display** | Specify the type of **link types** to be displayed by the gadget: * **All link types** - the default option; select this option if you want all the link types to be displayed in the diagram * **Only these link types** - select this option if you want the gadget to display only the specified link types in the diagram This option applies only when the visualization mode is set to **"Linked Work Items View."** | | **Linked issue depth** | Specify how many levels of linked issues to be displayed by the gadget. This option applies only when the visualization mode is set to **"Linked Work Items View."** | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ## Related blog articles The following blog articles provide more information on how to use this gadget. * * * --- language: "en" --- # Worklog Reports & Timesheets Gadget This gadget is available only in the **Advanced Edition** of Great Gadgets. ## Overview The **Worklog Reports \& Timesheets** gadget helps teams analyze and report on time logged in Jira. It provides flexible reporting options that allow you to visualize worklog data in pivot tables or charts, making it easier to understand how time is distributed across projects, team members, and work items. Use this gadget to monitor individual or team effort, review logged hours, track workload distribution, and support internal reporting or billing processes. With default presets and filtering options, you can quickly generate detailed timesheets or high-level effort summaries tailored to your needs. You can generate weekly or monthly summaries grouped not only by Worklog Author or Worklog Date, but also by work item fields such as Priority, Project or other available fields. The gadget supports multiple filtering options, allowing you to tailor reports for operational tracking, workload analysis, internal reporting, or billing purposes. ![Worklog-table-report-by-author,-date-and-time-spent.png](https://documentation.stonikbyte.com/__attachments/a_706db1798b1f57dc92663816bbeabcec0e7c68181becbf3488855a7a02c2cd52/Worklog-table-report-by-author,-date-and-time-spent.png?cb=b471f476fbcdfa94542da24497131ce0) ![Worklog-table-report-by-author-and-date---heatmap.png](https://documentation.stonikbyte.com/__attachments/a_1b33ba14d451062b0051ebfeab88d6380b5cc287d194b3f1df7ceff70c4b7494/Worklog-table-report-by-author-and-date---heatmap.png?cb=a89702bdb278f44acbe0384bb009b015) ![Worklog---charts.png](https://documentation.stonikbyte.com/__attachments/a_99c1c12e95dd725cb8e7a0c5248fae1f04a96496155021e0fd06b29e56beb72b/Worklog---charts.png?cb=8350d0b94d6f7111ed94b65df4261c88) ## Configuration The settings of this gadget are divided in multiple tabs: * **Data** tab - contains the required settings of the gadget, such as title or data source * **More Settings** tab - contains the optional settings * **Colors tab** - lets you choose the base color of the heatmap table ### Data tab On this tab you can configure the required settings of the gadget. ![Worklog-Reports-&-Timesheets-configuration-data-tab.png](https://documentation.stonikbyte.com/__attachments/a_a329e3a9aed3c319ec280649ee8c9abb68ab01f9ebf6b58a7908b688dd2c399c/Worklog-Reports-&-Timesheets-configuration-data-tab.png?cb=98b077e2f3b71ebceeca0f271e9c7c5b) | **Setting** | **Description** | |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Data Source** | Select the type of **Data Source** used by the gadget --- the work items that contain the worklogs you want to process. * A **Saved filter** containing the work items that you want to track. Make sure that the specified filter is shared with the users who will also visualize this gadget. * A **JQL** query that returns the work items you want to be processed by the gadget. * **Epics** - Select one or more epics as the data source. * **Portfolio-level items** - Select one or more work items above the Epic level, such as Initiatives or Themes. When a board or filter is selected as the data source, click the ![Icon.png](https://documentation.stonikbyte.com/__attachments/a_5843b0c8fb205c1294f279e4709330e477823f6c2e3c6006d5824471288610fc/Icon.png?cb=2daeaa6a289364158e3803422c1e668b) icon next to its name if you want to view the selected board or filter in Jira. | | **Include sub-tasks** | Check this option if you want the sub-tasks from the selected filter or JQL to be included in the calculation. | | **Time interval** | Represents the time interval during which the worklogs to be processed were added. You can choose from multiple options: **Custom dates** - choose this option if you want to manually enter a *Start date* and an *End date*. **A number of days back** - By choosing this option, the gadget will use a rolling time interval with a number of days back to the current day. **From date -**choose this option if you want the gadget to display worklogs recorded from a specific date onward. **Current month -**choose this option to display worklogs recorded during the current calendar month. | | **Preset configuration** | Select one of the available presets as a starting point for the gadget configuration, or choose *Custom* to configure the gadget from scratch. Selecting a preset automatically changes the gadget settings in the Data and More Settings tabs. Presets available: * **Table report: Worklogs Comments by Author** -- Displays a table showing worklog entries grouped by author, including comments for each entry. * **Table report:** **Monthly Worklog Total by Team Member** -- Shows a table with the worklogs of the team members over time, grouped monthly. | | **Fields** | Select the work item fields you need to generate the table or chart. You can select worklog-specific fields such as *Worklog Author* , *Worklog Date* , *Worklog Time Spent* , and *Worklog Comment* , as well as work item fields such as *Priority* , *Project* , or *Status*. | | **Enable filtering by** | Use this option to narrow down the worklogs displayed in the gadget. You can filter by various Jira fields, such as project, issue type, assignee, or custom fields, to focus on specific worklog entries. | | **Output configuration** | This is the place where you can configure the pivot table or pivot chart. ![Worklog-Reports-&-Timesheets-output-configuration.png](https://documentation.stonikbyte.com/__attachments/a_a7c0a6955bb52bd8bd5913774f6358519c20966c9ed881c12198847deda1f6b3/Worklog-Reports-&-Timesheets-output-configuration.png?cb=52e5f83b705015298bbb4bf49c6f0e4c) ![1.png](https://documentation.stonikbyte.com/__attachments/a_5dd2fa0e219fcb04159ed9386ef58af9544f28fc94e67bd7a0b9ab69eb370922/40a2d15c-9479-461f-8850-c2e96ed8805d?cb=4cbc1f08f757a1aafba225cc186c4f38) Allows you to select the type of the output: pivot table or pivot chart. ![2.png](https://documentation.stonikbyte.com/__attachments/a_1c82680c1b9c0be673f53c1437cbc94ac57990c3895a0b5e63eb0a5e043d22ce/4977e2bd-03ab-4e0f-ad43-dd74aa010a3e?cb=f83d4d21bee107e0ed072d2c83d533ac) Configure the columns of the pivot table. You can place the necessary fields here using the drag \& drop functionality. ![3.png](https://documentation.stonikbyte.com/__attachments/a_3b9d0fa267d616e46f7eec9d66ce02b8ca36618950c081c4ab0df71536d9e660/43846007-2c6e-4a33-9d13-5aed5014e19a?cb=f8c8a9397d38e0caa7979d8fe1a81e49) Configure the rows of the pivot table. You can place the necessary fields here using the drag \& drop functionality. ![4.png](https://documentation.stonikbyte.com/__attachments/a_a0d827d08d08ffdbf2912020398428570329b998ac070d9f54e8914522caa5ff/1173f296-2cc8-4c3f-84b5-71edec148ed2?cb=8e069afcc4b948bfae9cd8f82cc394fc) The calculation method/formula. For example, to display the number of work items in table, select *Count* . To display the sum of an work item field, select *Sum* and then the select field. ![5.png](https://documentation.stonikbyte.com/__attachments/a_9a0cc8e0fd20281f17fccc97c6e79c6d92ba4f21508e8d1932335ed8c8df763a/0f8f6374-a9e7-4f17-bdfb-41d24f46ce74?cb=fcb245310ab0a2b3024b6f1ac20b3f47) A sample output of the gadget created using dummy data. ![6.png](https://documentation.stonikbyte.com/__attachments/a_b64d2a18a8f68ec00c7091f8d1f4f3034a1272280fde47a6235204e719692851/6a1f9846-613d-40f7-a2e6-fe478676cd20?cb=39f67dcd2e377042d72ead7105cec949) Unused fields. **Note** If you drag \& drop a field between the columns area ![2.png](https://documentation.stonikbyte.com/__attachments/a_66481b697048592f9ad335fbba705532b2ab000cc0bb4805be4ad3f04f253754/2.png?cb=a82cc6a3d1407549175b8a52f7426c50) and the rows area ![3.png](https://documentation.stonikbyte.com/__attachments/a_2caaf963b4e5e198ed828e660d68380aef7baeb6d4b0fe86026423319f2bef0b/3.png?cb=015a15a31e5107d1fb70bd3e0bc226c9) or vice versa, it will not be moved. Instead, it will be displayed on both places. This behavior is by design, because the gadget allows you to use a field in both rows and columns areas. To remove it from the columns area or from the rows area, just drag \& drop it into the unused fields area ![6.png](https://documentation.stonikbyte.com/__attachments/a_6e0f87075cb5b47e21424de7910fc6ab9dc6e1749b30ad9fd5329f37a08ec47c/6.png?cb=2cd244f5e5d868d49cc6ba58b6890b2e) . | ### More Settings tab On this tab you can configure the optional settings of the gadget. ![Worklog-Reports-&-Timesheets-configuration-more-settings-tab.png](https://documentation.stonikbyte.com/__attachments/a_6d1cc557b0f5fa22e8b2581d5472de5e3ffa9e791d87b1cbecbbf05301fe432d/Worklog-Reports-&-Timesheets-configuration-more-settings-tab.png?cb=7e691db3850db80fd3933a392961acc1) | **Setting** | **Description** | |-------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Fields formatting mode** | For the fields that you selected on the Data tab for being used, you may specify the format to be used for displaying their values. For example, for date fields like Worklog Date you can choose a format like "MM/dd/yyyy" or "yyyy", while for time fields like Worklog Time Spent you may choose to display the result in "Hours" or "Calendar Days (24h)". To display quarters of the year, choose a format that contains "Q", such as "Q yyyy" or "yy-Q". To display weeks of the year, choose "Week dd MMM yy" or "Week of MMM dd, yyyy". Also, you can choose a format that contains "ww", such as "ww yyyy" or "yy-ww". | | **Display the 'Totals' row** | Check this option if you want the pivot table to display the 'Totals' row. It takes effect only if the gadget is configured as *Table* , *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. | | **Display the 'Totals' column** | Check this option if you want the pivot table to display the 'Totals' column. It takes effect only if the gadget is configured as Table, *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. | | **Hide rows with zero totals** | Check this option if you want the pivot table to hide rows when their total value is zero. It takes effect only if the gadget is configured as *Table* or *Heatmap Table*. | | **Display the 'Percentage' column** | Check this option if you want the pivot table to display the 'Percentage' column. It takes effect only if the gadget is configured as *Table* , *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. The percentage value on a row is calculated based on the value of the Total cell from the same row as a fraction of the Grand Total value. | | **Display the 'Average' column** | Check this option if you want the pivot table to display the 'Average' column. It takes effect only if the gadget is configured as *Table* , *Table Heatmap* , *Table Col Heatmap* or *Table Row Heatmap*. You can choose to **Calculate the average based on**: * *all values* - the average will be calculated as the sum of cells divided by the number of cells * *non-zero values* - the average will be calculated as the sum of cells divided by the number of non-zero cells | | **Legend display** | This setting only applies to pivot charts. Indicates whether the chart legend should be displayed or not and where exactly. | | **Refresh interval** | Choose how often the gadget will refresh automatically. | ### Colors tab On this tab you can choose the base color for the heatmap table. ![Worklog-Reports-&-Timesheets-configuration-colors-tab.png](https://documentation.stonikbyte.com/__attachments/a_60b4647c218626d398606d4d0f22eb15912f5310b5dc2392ec02a5a38e5571f3/Worklog-Reports-&-Timesheets-configuration-colors-tab.png?cb=420626c61d0e2217e91a895312f2f63a) | **Setting** | **Description** | |------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Heatmap base color** | This option lets you adjust the hue (color tone) used to generate the heatmap color palette. It applies only when the widget output is set to *Table Heatmap* , *Table Column Heatmap* , or *Table Row Heatmap*. The widget also automatically adjusts the text color based on the background color to ensure optimal readability. | --- language: "en" --- # Pivot Worklog Reports ## Pivot Worklog Reports Welcome to the documentation space of Pivot Worklog Reports marketplace app. * ### [What is Pivot Worklog Reports?](https://documentation.stonikbyte.com/pivot-worklog-reports/what-is-pivot-worklog-reports.md) * #### [Installing and configuring the app](https://documentation.stonikbyte.com/pivot-worklog-reports/installing-and-configuring-the-app.md) * #### [How to use the app](https://documentation.stonikbyte.com/pivot-worklog-reports/how-to-use-the-app.md) * #### [Gadgets offered](https://documentation.stonikbyte.com/pivot-worklog-reports/gadgets-offered.md) * #### [Advanced Edition Features](https://documentation.stonikbyte.com/pivot-worklog-reports/advanced-edition-features.md) * #### [Data Residency](https://documentation.stonikbyte.com/pivot-worklog-reports/data-residency.md) * #### [FAQs](https://documentation.stonikbyte.com/pivot-worklog-reports/faqs.md) --- language: "en" --- # Advanced Edition Features The **Advanced Edition** of **Pivot Worklog Reports**provides enhanced capabilities, priority support, and expert guidance to help teams get the most value from their Agile reporting and dashboards. This edition is designed for organizations that require **advanced reporting, faster support, and expert assistance for setup and optimization**. ## Priority Support Advanced Edition customers receive **priority access to the Pivot Worklog Reports support team**, ensuring faster assistance when issues arise. ### What You Get * **Faster response times** for support requests * **Priority handling** in the support queue * **Live Zoom sessions** for troubleshooting when needed * **Dedicated phone line** for urgent cases If you have the **Advanced Edition** of **Pivot Worklog Reports** , you can find the **emergency support phone line** in **Jira Administration \> Marketplace Apps \> Pivot Worklog Reports**. ### Benefits * Minimize downtime and disruptions * Resolve issues faster with direct access to experts * Get real-time assistance for complex problems ## Dedicated Customer Success Manager Advanced Edition includes **live enablement sessions** with a dedicated Customer Success Manager to help your team configure and optimize Pivot Worklog Reports for your workflows. ### What's Included * Ongoing support from your **dedicated Customer Success Manager** * **Live Zoom demonstration** of the app's capabilities * Guidance on **best practices for dashboards and reports** * Help with **configuration and setup** * Advice on **optimizing gadgets for your use cases** If you have the **Advanced Edition** of **Pivot Worklog Reports** , you can find your **Customer Success Manager** in **Jira Administration \> Marketplace Apps \> Pivot Worklog Reports**. Use the provided contact details to schedule a call when necessary. ### Benefits * Accelerate adoption across your teams * Ensure dashboards and reports are configured correctly * Unlock advanced features faster ## Migration Assistance If you are migrating from **Jira Server or Data Center to Jira Cloud**, Advanced Edition includes guided assistance to ensure a smooth transition. ### What's Included * Guidance during the **migration process** * Help with **configuration alignment between environments** * Assistance validating **dashboard and gadget configurations** * Support for **data validation after migration** ### Benefits * Reduce migration risks * Ensure dashboards and reports work correctly in Cloud * Save time during the transition process --- language: "en" --- # Data Residency ## What is Data Residency? **Data residency** is a feature that allows you to select and pin the geographical location (e.g., USA, EU, India, Australia) where your app data is stored. This ensures compliance with data privacy regulations by keeping your data within specific regions. ## Enabling Data Residency in Pivot Worklog Reports Data residency is disabled by default, which means app data is stored in a global table replicated across USA and EU geographical regions. This replication ensures better availability and optimizes app performance. Follow these steps to enable **Data Residency** for **Pivot Worklog Reports** and select the region where your app data will be stored: * Log in to **Jira Cloud** as an**administrator**. * Navigate to **Settings \> Marketplace apps** * Click **Pivot Worklog Reports** in the left-hand navigation pane. * **Enable** **Data Residency** and select one of the available geographical locations to store your app data. ![image-20261016-124322.png](https://documentation.stonikbyte.com/__attachments/a_493eb5c26a1f17bc9d0e4dabd31d46de01f618c3644564bbc79aba6733011113/image-20261016-124322.png?cb=85ffbb8a5bc850a03befef3ba22ce374) * Click **Save** to apply the changes Once you save the changes, new data will be stored in the selected location. Any data remaining in the previous location will be automatically deleted within 90 days. These options are not available for AGC Jira Cloud instances, as it uses separate storage located in the USA to store application data. ## Frequently asked questions ### What Data Does the Pivot Worklog Reports App Store? For details on the data stored by the Pivot Worklog Reports app, please refer to the [Privacy \& Security](https://marketplace.atlassian.com/apps/89496753/pivot-worklog-reports-timesheets-charts-heatmaps?tab=privacy-and-security) tab on the app listing in the Atlassian Marketplace. ### Can I Disable Data Residency After Enabling It? Yes. You can disable **Data Residency** at any time. Once disabled, new data will be stored in the global location, and any data remaining in the previous region will be automatically deleted within 90 days. For any questions regarding Data Residency or the Pivot Worklog Reports app, please contact StonikByte Support by submitting a ticket [here](https://stonikbyte-production.atlassian.net/servicedesk/customer/portal/1) or by emailing [support@stonikbyte.com](mailto:support@stonikbyte.com). --- language: "en" --- # FAQs ## What is Pivot Worklog Reports? Pivot Worklog Reports is a Jira dashboard app that helps teams analyze and report on time logged in Jira. It transforms existing Jira worklogs into detailed timesheets, multidimensional pivot reports, heatmaps, and charts. Teams can analyze logged time by author, date, project, work item, priority, status, or another supported Jira field. ## Which gadget is included in the app? The app includes the **Worklog Reports \& Timesheets gadget**. The gadget can be configured to display detailed worklog entries, summarized timesheets, heatmaps, and visual charts. ![GG-Logo---40x40px.png](https://documentation.stonikbyte.com/__attachments/a_e921a41e1c51e9ae54372751608dc409ca07b37ea53d908b39c0d850294ff6c6/GG-Logo---40x40px.png?cb=ac9410f63b26b615c7505ec495f2b8c8) The **Worklog Reports \& Timesheets** gadget is available either through this standalone app or as part of [Great Gadgets for Jira](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App), the complete bundle that provides a broader collection of dashboard gadgets in a single app. ## Who is the app designed for? The app is useful for Project Managers, Delivery Managers, Team Leads, Scrum Masters, Agile Coaches, ITSM Managers, Support Managers, Resource Managers, Consultants, Finance and Billing Teams, Jira Administrators, and PMOs. It can be used by Scrum, Kanban, SAFe®, ITSM, development, operations, consulting, service, and business teams that record time in Jira. ## Is a free trial available? Yes. You can start a free 30-day trial from the app's listing on the [Atlassian Marketplace](https://marketplace.atlassian.com/apps/89496753/pivot-worklog-reports-timesheets-charts-heatmaps?tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=FAQs). ## Do I need Jira administrator permissions to use the gadget? A Jira administrator is generally required to install the app. After installation, users with permission to create or edit Jira dashboards can add and configure the gadget. Users must also have permission to view the Jira projects, work items, filters, and worklog information included in the report. ## Does the app create or modify Jira worklogs? No. Pivot Worklog Reports is a reporting app. Team members continue to create, edit, or delete their worklogs through Jira. The gadget reads the existing Jira worklog data and presents it as a table, heatmap, or chart. ## Do I need to know JQL? No. You can create a report using a saved filter or by selecting epics or portfolio-level work items. JQL is available when you need more precise control over the work items included in the report or want to combine work from multiple projects, teams, customers, or other scopes. ## Which data sources can I use? You can create worklog reports using work items returned by: * A saved Jira filter * A JQL query * One or more epics * One or more portfolio-level work items, such as initiatives or themes If you use a saved filter, make sure it is shared with everyone who needs to view the gadget. ## Can I report on worklogs from multiple projects or teams? Yes. Use a saved filter or JQL query that returns work items from all the projects or teams that you want to include. You can then group the worklogs by Project, Worklog Author, Assignee, Work Item Type, or another supported field. When several teams or projects are combined, the totals represent their aggregated logged time. ## Which worklog fields can I use? Available worklog-specific fields include: * Worklog Author * Worklog Date * Worklog Time Spent * Worklog Comment These fields can be combined with supported Jira work-item fields to create detailed or summarized reports. ## Which Jira fields can I use? You can combine worklog data with Jira fields such as: * Project * Status * Priority * Work Item Type * Assignee * Epic or parent hierarchy * Other supported custom fields The exact fields available depend on your Jira configuration, field contexts, permissions, and selected data source. ## Can I use custom Jira fields? Yes. Supported custom fields can be selected for the report or used to filter its data. For example, if your work items contain fields for Customer, Department, Cost Center, Team, or Work Category, you may be able to use those fields to organize or filter the worklog report. ## Can I filter the worklogs displayed in the report? Yes. The **Enable filtering by** option allows you to narrow down the displayed data using supported Jira fields. For example, you can focus the report on a particular: * Project * Work Item Type * Assignee * Priority * Status * Custom fields Filtering is useful when the main data source contains a broad set of work items but the report should show only a specific subset. ## Can I include subtasks? Yes. Enable **Include sub-tasks** if worklogs recorded on related subtasks should be included. This is important when team members log time on subtasks instead of their parent work items. ## Can I display worklog comments? Yes. Add the **Worklog Comment** field to the report or use the **Table Report: Worklog Comments by Author** preset. This allows you to review the descriptions entered with individual worklogs together with their authors, dates, and logged time. ## Can I create individual timesheets? Yes. Use Worklog Author, Worklog Date, Worklog Time Spent, and optionally Worklog Comment to create a detailed timesheet. You can filter the data source or report to focus on a specific person, team, project, or reporting period. ## How do I configure the rows and columns? First, select the fields that you want to use. Then drag and drop them into the Rows and Columns areas of the output configuration. ## Can I use the same field in both rows and columns? Yes. A field can appear in both areas. Dragging a field from Rows to Columns, or from Columns to Rows, adds it to the new area without removing it from the original one. To remove the field from one area, drag it into the Unused Fields area. ## Which report formats are available? The gadget can display worklog information as: * Regular pivot tables * Table heatmaps * Column heatmaps * Row heatmaps * Pivot charts ## Can I display totals? Yes. Supported table and heatmap outputs can display: * A Totals row * A Totals column ## Can the app be used for billing reports? Yes. The app can provide detailed worklog information to support billing reviews, customer reports, internal cost allocation, or invoice preparation. However, it is a reporting tool rather than an invoicing or timesheet-approval system. It does not create invoices or approve worklogs. If you need to distinguish between billable and non-billable work, that classification must be represented by the report's Jira fields, filters, projects, or another supported data attribute. ## Is the Worklog Reports \& Timesheets gadget also available in Great Gadgets? Yes. The gadget is included in the **Advanced Edition of** [**Great Gadgets for Jira**](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App), StonikByte's complete Jira dashboard reporting suite. ## Is the gadget included in the Standard Edition of Great Gadgets? No. The Worklog Reports \& Timesheets gadget is available only in the Advanced Edition of [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App). ## Which app should I choose? Choose **Pivot Worklog Reports** when you need a focused solution for creating Jira timesheets, worklog pivot reports, heatmaps, and charts. Choose the **Advanced Edition of** [**Great Gadgets for Jira**](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App) when you also need burndown and burnup charts, release forecasts, velocity and throughput reports, WIP charts, cycle time and lead time analytics, cumulative flow diagrams, time-in-status reports, pivot tables, custom KPIs, work breakdown structures, and other dashboard capabilities in one app. ## Do I need the standalone app if I already have the Advanced Edition of Great Gadgets? No. If the Advanced Edition of [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App) is already installed and licensed, you can use the Worklog Reports \& Timesheets gadget included in that app. ## Is Great Gadgets licensed separately? Yes. Pivot Worklog Reports and [Great Gadgets](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App) for Jira are separate Atlassian Marketplace apps, each with its own installation and license. --- language: "en" --- # Gadgets offered |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ![Gadgets-offered---worklog.png](https://documentation.stonikbyte.com/__attachments/a_dabdbf37aedc5a9972ce377c4aebf9965714a8d326f29d8f1e32a5ae59ef8fb2/Gadgets-offered---worklog.png?cb=f31ea91fcbd5be7a0c34b0206725ad81) | **Worklog Reports \& Timesheets Gadget** Available only in the Advanced Edition of Great Gadgets. This gadget helps teams analyze and report on time logged in Jira. It provides flexible reporting options that allow you to visualize worklog data in pivot tables or charts, making it easier to understand how time is distributed across projects, team members, and work items. For more details, see: [Worklog Reports \& Timesheets Gadget](https://documentation.stonikbyte.com/great-gadgets/worklog-reports-timesheets-gadget.md) project management release management TIME management | ![GG-Logo---40x40px.png](https://documentation.stonikbyte.com/__attachments/a_5fb97a33106b883765e2efa9132aca29f93211a623445e3a4bd9ad830fcc0b73/GG-Logo---40x40px.png?cb=ac9410f63b26b615c7505ec495f2b8c8) The **Worklog Reports \& Timesheets** gadget is available either through this standalone app or as part of [Great Gadgets for Jira](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App), the complete bundle that provides a broader collection of dashboard gadgets in a single app. --- language: "en" --- # How to use the app Once you installed and configured the app (see [Installing and configuring the app](https://documentation.stonikbyte.com/pivot-worklog-reports/installing-and-configuring-the-app.md)), you can start using the dashboard gadgets. To add a gadget to a dashboard: * In Jira, go to Dashboards * Create a new dashboard or select an existing one * Click the **Add gadget** button of the dashboard * In the "Add a gadget" screen, filter by "worklog" to display all the gadgets of the app ![image-20261015-073418.png](https://documentation.stonikbyte.com/__attachments/a_1a627c7a1ca75d0f881b6f976e2e4e832ecd7a798a230ac1c9f04abb3c7667ef/image-20261015-073418.png?cb=5468c0136e8a263962168108182d445d) * Click the "Add gadget" button of the gadget that you want to add * Once you added the gadgets, close the "Add a gadget" screen and continue by entering the gadget settings. See below the instructions for how to configure the gadgets. ## Using the gadgets in Confluence Cloud For using the gadgets in Confluence Cloud you have to simply copy and paste the gadgets in a Confluence page. ![image-20261015-073743.png](https://documentation.stonikbyte.com/__attachments/a_e1c350b5a20cc42361d4c1eaa9eee27fb3044088defe93daa6e9bbbebf5076c4/image-20261015-073743.png?cb=69e61bd378eab14a58ff2f6bd9ffab71) ## Using the gadgets in wallboard mode In Jira, you can display the gadgets in wallboard mode to make them visible on big TV screens as information radiators, for example. ![image-20261015-074040.png](https://documentation.stonikbyte.com/__attachments/a_be54351ac535746dc81d1aefddebfb1c8aa4a9cb62689912fd7790f1cd5c4b90/image-20261015-074040.png?cb=712bd6dec9b3f785df2f64688b18abc6) To trigger the wallboard mode, click the **View as wallboard** option of the Jira dashboard's menu. ![Artboard 3.png](https://documentation.stonikbyte.com/__attachments/a_1add13d7d5936339fc5e80afe8b4c48478666fbc3ade3a59590fc59b383dda9c/Artboard%203.png?cb=d8be53bd46b90e5dae4a1b936d68a84c) ## Dark Theme Support The application fully supports Dark Theme mode. ## Supported languages The app for Jira Cloud and Confluence Cloud is fully localized in English, Spanish, French, Portuguese, German and Romanian. For on-screen texts to appear localized, the Jira user must have one of these languages enabled in their Jira profile. Otherwise, they will be displayed in English. --- language: "en" --- # Installing and configuring the app Follow these steps to install and configure the Pivot Worklog Reports app in your Jira instance: 1. Go to [https://marketplace.atlassian.com/apps/89496753/pivot-worklog-reports-timesheets-charts-heatmaps?tab=overview\&utm_source=documentation\&utm_medium=referral\&utm_campaign=Installing_configuring_the_app](https://marketplace.atlassian.com/apps/89496753/pivot-worklog-reports-timesheets-charts-heatmaps?tab=overview&utm_source=documentation&utm_medium=referral&utm_campaign=Installing_configuring_the_app) and log in with your Jira admin account. ![image-20261016-131430.png](https://documentation.stonikbyte.com/__attachments/a_28b3e9d2e8ba671f69cb03d2a8a7711f95bc3f84cb913e8d67544b53d60b046a/image-20261016-131430.png?cb=fca59c39583c73d7a377d4f1c6266798) 2. Click **Try it free** to start the installation process. 3. Select the Atlassian site where you want to install the app. 4. Follow the on-screen instructions to complete the installation. Complete the post-install configuration: 5. (Optional) Enable data residency. For details, see: [Data Residency](https://documentation.stonikbyte.com/pivot-worklog-reports/data-residency.md) . 6. If your Jira Cloud instance uses IP allowlists, add the app IP addresses to your allowlists. For more information, see [Technical Notes \| IP Allowlisting](https://documentation.stonikbyte.com/great-gadgets/technical-notes.md#IP-Allowlisting). Once these steps are complete, the app is configured and ready to use. For more information, see: [How to use the app](https://documentation.stonikbyte.com/pivot-worklog-reports/how-to-use-the-app.md) . --- language: "en" --- # What is Pivot Worklog Reports? ![GG-Logo---40x40px.png](https://documentation.stonikbyte.com/__attachments/a_b978d3f8e1b174eb0b67e1fabf1465f3ea7c9eb501cd28fcedf0d6368a26d82f/GG-Logo---40x40px.png?cb=ac9410f63b26b615c7505ec495f2b8c8) The **Worklog Reports \& Timesheets** gadget is available either through this standalone app or as part of [Great Gadgets for Jira](https://marketplace.atlassian.com/apps/1216564/great-gadgets-for-jira-cloud-agile-charts-reports-kpis?utm_source=documentation&utm_medium=referral&utm_campaign=Pivot_Worklog_Reports_App), the complete bundle that provides a broader collection of dashboard gadgets in a single app. **Pivot Worklog Reports** is a Jira dashboard app that helps Scrum, Kanban, SAFe®, ITSM, project, service, and business teams analyze and report on the time logged in Jira. Turn Jira worklogs into detailed timesheets, multidimensional pivot reports, heatmaps, and charts. Track individual and team effort, understand how time is distributed across projects and work items, review worklog comments, and create weekly or monthly summaries without manually exporting the data to spreadsheets. The app helps you answer questions such as: * How much time has been logged during a selected period? * Who logged time, when, and on which work items? * How is the team's effort distributed across projects? * Which epics, initiatives, or work items consume the most time? * How much time is spent on different work item types, priorities, or statuses? * How does logged effort change from one week or month to another? * What percentage of the total logged time belongs to each project or team member? * Which comments were added to individual worklog entries? * How is effort distributed across team members? * Which worklogs should be reviewed for internal reporting or billing purposes? ## Key features ### Detailed timesheets and summarized reports Use the same gadget to create both detailed worklog reports and high-level effort summaries. Detailed reports can show individual worklog entries together with their authors, dates, time spent, comments, and related Jira fields. Summary reports can aggregate worklogs by team member, project, work item, week, month, or another relevant dimension. ### Multiple report formats Display worklog data as: * Regular pivot tables * Table heatmaps * Row heatmaps * Column heatmaps * Pivot charts ### Multidimensional drag-and-drop reporting Create reports by dragging selected fields into the Rows and Columns areas. Multiple fields can be placed in the same report, allowing you to analyze Jira worklogs from several perspectives. ### Multiple data sources Create worklog reports using work items returned by: * Saved filters * JQL queries * Epics * Portfolio-level work items, such as initiatives or themes Saved filters and JQL queries can include work items from multiple projects or teams, making it possible to create consolidated reports for departments, programs, customers, or broader delivery initiatives. ### Flexible reporting periods Choose which worklogs should be included using options such as: * Custom start and end dates * A configurable number of days back from the current date * All worklogs recorded from a specific date onward * The current calendar month * These options support both fixed reporting periods and rolling reports that remain current as time passes. ### Worklog-specific fields and Jira fields Build reports using worklog-specific fields such as: * Worklog Author * Worklog Date * Worklog Time Spent * Worklog Comment You can combine them with Jira work-item fields such as: * Project * Status * Priority * Work Item Type * Assignee * Epic or parent hierarchy * Other supported custom fields This allows you to understand not only how much time was logged, but also where that effort was invested. ### Ready-to-use report presets Use a predefined report as a starting point or select **Custom** to build a report from scratch. Available presets include: * **Table Report: Worklog Comments by Author:** Displays individual worklog entries grouped by author, including the date, time spent, and comment associated with each entry. * **Table Report: Monthly Worklog Total by Team Member:** Displays the total time logged by each team member, grouped by month. * **Pie Chart: Who Worked the Most in Each Project:** Visualizes how logged time is distributed among team members and projects, helping you identify the largest contributors. * **Stacked Column Chart: Monthly Hours Logged by Person:** Shows the hours logged each month, split by team member, making it easier to compare individual contributions and changes in effort over time. Selecting a preset automatically configures the relevant settings, which you can then adjust to match your reporting needs. ### Flexible worklog filtering Use additional filters to narrow down the worklogs displayed in the report. You can filter the results using fields such as: * Project * Work Item Type * Assignee * Priority * Status * Supported custom fields This allows you to create focused reports for a specific project, team, customer, category of work, or reporting purpose. ### Configurable calculations and summaries Calculate and summarize worklog data using options such as: * Worklog or work-item count * Sum of Worklog Time Spent * Sum of other supported numerical fields * Totals by row or column * Percentage of the grand total * Average values calculated using all cells or only non-zero cells This supports both detailed time analysis and high-level effort reporting. ### Subtask support Include subtasks associated with the work items returned by a saved filter or JQL query. This provides a more complete view when team members log time directly on subtasks rather than on their parent work items. --- language: "en" --- # WIP Run & WIP Aging Charts Documentation ## WIP Run \& WIP Aging Charts Documentation Welcome to the documentation space of WIP Run \& WIP Aging Charts marketplace app. * ### [What is WIP Run and WIP Aging Charts?](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/what-is-wip-run-and-wip-aging-charts.md) * #### [Installing and configuring the app](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/installing-and-configuring-the-app.md) * #### [How to use the app](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/how-to-use-the-app.md) * #### [Gadgets offered](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/gadgets-offered.md) * #### [Advanced Edition Features](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/advanced-edition-features.md) * #### [Data Residency](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/data-residency.md) * #### [FAQs](https://documentation.stonikbyte.com/wip-run-wip-aging-charts/faqs.md) --- language: "en" --- # Advanced Edition Features The **Advanced Edition** of **WIP Run \& WIP Aging Charts**provides enhanced capabilities, priority support, and expert guidance to help teams get the most value from their Agile reporting and dashboards. This edition is designed for organizations that require **advanced reporting, faster support, and expert assistance for setup and optimization**. ## Priority Support Advanced Edition customers receive **priority access to the WIP Run \& WIP Aging Charts support team**, ensuring faster assistance when issues arise. ### What You Get * **Faster response times** for support requests * **Priority handling** in the support queue * **Live Zoom sessions** for troubleshooting when needed * **Dedicated phone line** for urgent cases If you have the **Advanced Edition** of **WIP Run \& WIP Aging Charts** , you can find the **emergency support phone line** in **Jira Administration \> Marketplace Apps \> WIP Run \& WIP Aging Charts**. ### Benefits * Minimize downtime and disruptions * Resolve issues faster with direct access to experts * Get real-time assistance for complex problems ## Dedicated Customer Success Manager Advanced Edition includes **live enablement sessions** with a dedicated Customer Success Manager to help your team configure and optimize WIP Run \& WIP Aging Charts for your workflows. ### What's Included * Ongoing support from your **dedicated Customer Success Manager** * **Live Zoom demonstration** of the app's capabilities * Guidance on **best practices for dashboards and reports** * Help with **configuration and setup** * Advice on **optimizing gadgets for your use cases** If you have the **Advanced Edition** of **WIP Run \& WIP Aging Charts** , you can find your **Customer Success Manager** in **Jira Administration \> Marketplace Apps \> WIP Run \& WIP Aging Charts**. Use the provided contact details to schedule a call when necessary. ### Benefits * Accelerate adoption across your teams * Ensure dashboards and reports are configured correctly * Unlock advanced features faster ## Migration Assistance If you are migrating from **Jira Server or Data Center to Jira Cloud**, Advanced Edition includes guided assistance to ensure a smooth transition. ### What's Included * Guidance during the **migration process** * Help with **configuration alignment between environments** * Assistance validating **dashboard and gadget configurations** * Support for **data validation after migration** ### Benefits * Reduce migration risks * Ensure dashboards and reports work correctly in Cloud * Save time during the transition process [Next Page](https://documentation.stonikbyte.com/llms-full.txt/1)