Gadgets for Jira applications

Adding and customizing gadgets

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Gadgets let you customize the information you display on dashboards or wallboards in Jira applications. This information may include the number of open and resolved issues, labels used in selected projects, version reports, and many more.

Both Jira admins and users can manage gadgets on dashboards. The Jira admin can make changes to the system dashboard, while users can only create and customize their personal dashboards. What the user can see in gadgets on the dashboard depends on global and project permissions.

On this page, you’ll find all the gadgets that you can install on dashboards in Jira Core (JC), Jira Software (JSW), and Jira Service Management (JSM), including additional Bamboo, Crucible, and FishEye gadgets.

GadgetJCJSWJSMDescription
Jira Core gadgets
Assigned to Me(tick)(tick)(tick)Shows all unresolved issues assigned to you.
Bubble Chart(tick)(tick)(tick)

Tracks the correlation of issues in a project or filter during a configured period based on:

  • the number of days issues have been open
  • the number of comments in issues
  • the number of participants or votes in issues
Notes

The horizontal axis represents the number of days when issues remained open. The vertical axis represents the number of comments in issues.

The bubble colors also indicate the correlation between the days when issues remained open and the number of comments. The green indicates low values and the red color indicates high values.

Only the first 200 open issues are displayed on the bubble chart.

You can configure the following settings for the chart:

  • the period during which issue comments are considered recent
  • the basis of the bubble size (participants or votes)
  • automatic refresh of the bubble chart data every 15 minutes
  • relative coloring to distinguish issues with more comments from issues with fewer comments
  • logarithmic scale (the linear scale is the default) to distribute the bubbles from each other. We recommend that you use the logarithmic scale if the bubble chart contains a large range of data.
Created vs. Resolved Chart(tick)(tick)(tick)

Shows the work progress by showing the number of created and resolved issues for a set period.

Notes

The chart is based on your choice of project or issue filter. The chart can be either cumulative or show the issue count.

An issue is marked as resolved in the time period if its resolution date fits into this period.

The resolution date is the last date when the Resolution field was set to any non-empty value.

Favorite Filters(tick)(tick)(tick)Shows a list of all issue filters that you've added as favorite filters.
Filter Results(tick)(tick)(tick)Shows the results of a selected issue filter on the dashboard.
Introduction(tick)(tick)(tick)
Lets you configure a message on the dashboard to say hello to users.
Notes

The text or HTML displayed in the gadget should be configured by the Jira admin.

To do this:

  1. Go to Administration > System.
  2. In the left panel, go to General configuration.
  3. Select Edit settings.
  4. In the Introduction field, type the text that will be displayed as the introduction message on the dashboard.
  5. At the bottom of the page, select Update to save the changes.
Issue Statistics(tick)(tick)(tick)Shows issue statistics returned from a selected project or saved filter (grouped by a selected field).
Issues In Progress(tick)(tick)(tick)Shows all issues that are currently in progress and assigned to you.
Labels Gadget(tick)(tick)(tick)Shows a list of all labels used in a selected project.
Pie Chart(tick)(tick)(tick)Shows aggregated data on issues based on a selected filter.
Quick Links(tick)(tick)(tick)Adds links to frequently used searches and operations.
Two Dimensional Filter Statistics(tick)(tick)(tick)Shows data based on a selected issue filter. For example, you can create a filter to retrieve all open issues in a particular project. Then, you can configure the gadget to display the statistical data on this collection of issues in a table with configurable axes.
Voted Issues(tick)(tick)(tick)Shows all issues you've voted for.
Watched Issues(tick)(tick)(tick)Shows all issues you're watching.
Atlassian gadgets
Activity Stream(tick)(tick)(tick)Shows activity on your instance. (Think of it as of a news feed.)
Average Age Chart(tick)(tick)(tick)
Shows the average age of unresolved issues.
Notes

This chart is based on your choice of project or issue filter and units of time (hours, days, weeks, months, quarters, or years).

For the purposes of this gadget, an issue is defined as unresolved if it has no value in the Resolution field.

The age of the issue is the difference between the current date and the date when the issue was created.

Heat Map(tick)(tick)(tick)

Shows the relative weighting of a selected field’s values in issues of a selected project or filter.

For example, this gadget can be configured to show a heat map of issue priority in a particular project.

Jira Road Map(tick)(tick)(tick)Shows which versions are due for release in a set period, as well as a summary of the progress made towards completing the issues in the versions.
Projects(tick)(tick)(tick)Shows information on various issue filters from a selected project.
Recently Created Chart(tick)(tick)(tick)Show a rate at which issues are being created as well as how many of these issues are resolved.
Resolution Time(tick)(tick)(tick)
Shows trends in the average time taken to resolve issues.
Notes

The report is based on your choice of project or issue filter and units of time (hours, days, weeks, months, quarters, or years).

The resolution time is the difference between the dates when an issue was created and resolved.

If the resolution date isn’t set, the gadget won’t consider this issue.

The resolution date is the last date when the Resolution field was set to any non-empty value.

Time Since Chart(tick)(tick)(tick)
Show the number of issues for which a selected field was set on a selected date (for example, Created, Updated, Due, Resolved, or a custom field).
Notes

The Resolved field here is the system Resolution Date field. This is the last date when the Resolution field was set to any non-empty value.

The report is based on your choice of project or issue filter and units of time (hours, days, weeks, months, quarters, or years).

Wallboard Spacer Gadget(tick)(tick)(tick)
Lets you modify the layout of your wallboards by adding custom space between gadgets.
Notes

You should set the height of a spacer in pixels and place the gadget in the preferred position on the dashboard.

You can’t modify the gadget’s color as it matches the black background color in the wallboard view.

Jira Software gadgets
Agile Wallboard Gadget
(tick)
Helps you see how you’re tracking with an agile board on your wallboard or dashboard.
Days Remaining in Sprint Gadget
(tick)
Shows how many working days you have before the current sprint ends.
Sprint Burndown Gadget
(tick)
Shows the burndown for a sprint in a line chart.
Notes

The vertical axis represents the estimation statistic.

The gadget will only display uncompleted sprints.

Sprint Health Gadget
(tick)
Shows a summary of issues in a sprint in a color-coded bar graph.
Notes

The colors in this gadget match the colors in the column configuration.

The completed work is calculated based on the estimation statistic for a board and is represented with the green part of the progress bar. For example, if you have 50 story points in a sprint and you have 3 resolved issues with 10 story points, the Work complete will be 20% (10 out of 50 story points).

The gadget doesn’t show the progress of work logged in the Remaining Estimate and Time Spent fields in Jira.

Adding or removing an issue from a started sprint is considered a change of scope. The percentage is calculated by using the statistic configured for the board. For example, if you started a sprint with 50 story points and add an issue with 5 story points, the Sprint Health gadget will show a 10% scope change.

If you add or remove issues without estimates, the scope change won’t be altered.

If you're using Jira’s time tracking, the scope change won’t show.

The Blocker field counts all blockers with the statuses To Do or In Progress.

For more information, see Configuring estimation and tracking

Version Report
(tick)
Tracks a projected release date for a version. This helps you monitor whether the version will release on time so you can take action if the work is falling behind.
Jira charting gadgets
Average Number of Times in Status(tick)(tick)(tick)
Shows the average number of times when issues had a selected status for a set period.
Notes

Requires the Jira Charting App installed.

Average Time in Status(tick)(tick)(tick)
Shows the average time that issues have spent in a selected status for a set period.
Time to First Response(tick)(tick)(tick)
Displays the number of hours that it takes to respond to issues in a project or filter.
Notes

Requires the Jira Charting App installed.

Workload Pie Chart(tick)(tick)(tick)
Uses a pie chart to show matching issues for a project or filter.
Notes

Requires the Jira Charting App installed.

Other gadgets
Jira Issues Calendar(tick)(tick)(tick)
Generates a calendar-based view of due dates for issues and versions.
Notes

Requires the Jira Calendar app installed.

Test Sessions(tick)(tick)(tick)Shows a list of test sessions.
Text(tick)(tick)(tick)
Shows HTML text on the dashboard.
Notes

This gadget is available if a Jira admin has enabled it. By default, the gadget is disabled because it causes a potential security risk. The gadget may contain arbitrary HTML which potentially may make your Jira system vulnerable to XSS attacks.

To enable the gadget:

  1. Go to Administration > Manage apps.
  2. In the left panel, select Manage apps to view the apps installed on the Jira site.
  3. In the dropdown list, select System.
  4. Find and select Atlassian Jira - Plugins - Gadgets Plugin.
  5. Find the Text module and select Enable.

If you can't enable the gadget, contact Atlassian Support for assistance.

Bamboo gadgets
Bamboo Charts(tick)(tick)(tick)
Shows Bamboo plan statistics in your dashboard.
Notes

If you want to add the gadget to the dashboard, a Jira admin should configure the Bamboo plugin on a Jira server. If you have multiple Bamboo servers added in Jira, only one Bamboo Charts gadget will be available per server.

When you add the gadget to the Jira dashboard, you may see the following message:

“The website (container) you have placed this gadget on is unauthorized. Please contact your system administrator to have it approved.”

To fix this, you should configure the Bamboo site to allow Jira to draw information from it via gadgets on the dashboard.

To do this, the Jira admin should first define the Jira site as an OAuth consumer in Bamboo. Then, you should perform a once-off authentication so that the gadget displays correctly.

Bamboo Plan Summary Chart(tick)(tick)(tick)
Shows a graphical summary of a Bamboo build plan.
Notes

If you want to add the gadget to the dashboard, a Jira admin should configure the Bamboo plugin on the Jira server. If you have multiple Bamboo servers added in Jira, only one Bamboo Plan Summary Chart gadget will be available per server.

When you add the gadget to the Jira dashboard, you may see the following message:

“The website (container) you have placed this gadget on is unauthorized. Please contact your system administrator to have it approved.”

To fix this, you should configure the Bamboo site to allow Jira to draw information from it via gadgets on the dashboard.

To do this, the Jira admin should first define the Jira site as an OAuth consumer in Bamboo. Then, you should perform a once-off authentication so that the gadget displays correctly.

Bamboo Plans(tick)(tick)(tick)
Shows a list of all plans on a particular Bamboo server and the current status of each plan.
Notes

If you want to add the gadget to the dashboard, a Jira admin should configure the Bamboo plugin on the Jira server. If you have multiple Bamboo servers added in Jira, only one Bamboo Plans gadget will be available per server.

When you add the gadget to the Jira dashboard, you may see the following message:

“The website (container) you have placed this gadget on is unauthorized. Please contact your system administrator to have it approved.”

To fix this, you should configure the Bamboo site to allow Jira to draw information from it via gadgets on the dashboard.

To do this, the Jira admin should first define the Jira site as an OAuth consumer in Bamboo. Then, you should perform a once-off authentication so that the gadget displays correctly.

Clover Coverage(tick)(tick)(tick)
Shows the clover coverage of plans from a particular Bamboo server.
Notes

If you want to add the gadget to the dashboard, a Jira admin should configure the Bamboo plugin on the Jira server. If you have multiple Bamboo servers added in Jira, only one Clover Coverage gadget will be available per server.

When you add the gadget to the Jira dashboard, you may see the following message:

“The website (container) you have placed this gadget on is unauthorized. Please contact your system administrator to have it approved.”

To fix this, you should configure the Bamboo site to allow Jira to draw information from it via gadgets on the dashboard.

To do this, the Jira admin should first define the Jira site as an OAuth consumer in Bamboo. Then, you should perform a once-off authentication so that the gadget displays correctly.

FishEye gadgets
Crucible Charts(tick)(tick)(tick)
Shows statistical summaries of your code reviews.
Notes

If you want to add the Crucible Charts gadget to your dashboard, a Jira admin should configure the FishEye app on your Jira server.

FishEye Charts(tick)(tick)(tick)
Shows Lines of Code data from a FishEye repository.
Notes

If you want to add the FishEye Charts gadget to the dashboard, make sure that:

1. The FishEye app is bundled with Jira Software and a working FishEye instance is linked to the Jira instance.

2. A link to the code repository is available. Only three types of repositories are applicable: subversion, perforce, or cvs.

Contact the Jira admin about these steps.

FishEye Recent Changesets(tick)(tick)(tick)
Shows two charts about your repository in one: Lines of Code and commit activity.
Notes

If you want to add the FishEye Recent Changesets gadget to the dashboard, make sure that:

1. The FishEye app is bundled with Jira Software and a working FishEye instance is linked to the Jira instance.

2. A link to the code repository is available. Only three types of repositories are applicable: subversion, perforce, or cvs.

Contact the Jira admin about these steps.



Last modified on May 25, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.