This page relates to the Cloud version of Rich Filters for Jira Dashboards. Please see the documentation index for Server & Data Center versions.

January 3, 2022

In this release:

New Gadgets: Rich Filter Simple Gauges and Rich Filter Smart Gauges

This release introduces two new gadgets which display gauges: Rich Filter Simple Gauges and Rich Filter Smart Gauges. These gadgets are similar to the Rich Filter Simple Counters and Rich Filter Smart Counters gadgets but, while the counters gadgets display aggregated values, the gauges gadgets display proportions and ratios. These can be derived from Issue Count, numeric & time-tracking issue fields, custom values or custom ratios, and can be displayed in one of three ways: as a gauge, as a percentage and fraction, or as a percentage only.

  • The Rich Filter Simple Gauges gadget can display up to 10 independent gauges. Each gauge can be configured with a filter & value pair or with a custom ratio – a dedicated configuration object for ratio definitions. The filter determines the gauge level by filtering the contributing issues. The value can be the Issue Count, a numeric or time-tracking field, or a custom value.




  • The Rich Filter Smart Gauges gadget is based on a smart filter and displays one gauge for each of the smart filter's clauses. The value on which the gauges are based can be the Issue Count, a numeric or time-tracking field, or a custom value. Two computation modes are available:
    • The smart clauses are used as gauge filters, i.e. they are used to compute the gauge levels relative to all the issues included in the gadget (all the gauges have the same total value). In other words, the collection of issues included in the gadget is partitioned according to the smart clauses, and the gauges reflect this partitioning.
    • The smart clauses are used to compute the gauge totals. All the gauges use the same gauge filter, which needs to be selected separately. In other words, the collection of issues included in the gadget is partitioned according to the smart clauses, and each of the resulting sub-collections is used to compute a simple gauge.
      For this computation mode, a custom ratio can be used instead of a gauge filter and a value.

Custom Ratios in gauge gadgets

This release introduces custom ratios, a new type of configuration object – similar to custom values – which further extends the capabilities of the rich filter gadgets. Custom ratios are defined as ratios, with a numerator and a denominator which can be based on Issue Count or numeric & time tracking fields. Optional JQL filtering conditions can be used to filter the contributing issues for the numerator and/or the denominator. Custom ratios can thus be used to compute ratios of different values.

Custom ratios are defined in the rich filter configuration and are available in the new gauges gadgets as a way to define proportions, providing a reusable and more flexible alternative to filter & value pairs. In future releases, custom ratios will be made available in other rich filter gadgets as well.

In the example below, four custom ratios are defined in the rich filter:

These custom ratios are used to configure four simple gauges, displayed as a percentage and fraction:

For more information about this new configuration object, have a look at the Configuring Custom Ratios documentation page.

Dynamic filtering and statistics

We extended the dynamic filtering and the statistic support with two more fields. It is now possible to add dynamic filters and to use as statistic type in statistics gadgets:

  • Project Category
  • Status Category