---
title: "Configure custom ratios"
canonical: "https://support.appfire.com/space/RFC/783942266/Configure%20custom%20ratios"
format: markdown
---
> Macro (aura-html)

## > Macro (anchor)

About custom ratios

Custom ratios are computed user-defined outputs that can be used in rich filter gadgets. They 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 filter the contributing issues for the numerator and/or the denominator. Custom ratios can thus be used to compute ratios of different values.

Below is an example of a *Rich Filter Simple Gauges* gadget that displays two gauges based on custom ratios: *Completion rate* and *Work ratio*.

![Rich Filter Simple Gauges gadget.png](media://0d887f2c-7497-4fb2-96ea-7a744901d132)

## > Macro (anchor)

Custom ratios key attributes

The **Custom ratios** section of your rich filter lets you add new custom ratios and view existing ones and their configurations.

![Custom ratio.png](media://31f79940-a246-45e2-8ef4-64b9368a4a57)

The **key attributes** of a custom ratio are:

| **Attribute** | **Description** |
| --- | --- |
| **Name** | Each custom ratio has a **Name** that must be unique among the custom ratios within the rich filter. |
| **Color** | The selected color will be used to display the ratio in some of the rich filter gadgets. |
| **Numerator**<br>**Base value** | The value on which the numerator of your custom ratio is based is selected among Issue Count or numeric and time-tracking fields.<br>![image](media://84d49968-fda9-4654-8e97-2a9a2c70991f) |
| **Numerator**<br>**JQL** | You can optionally define a JQL query to filter the issues contributing to the numerator of the custom ratio. Only the issues satisfying this query will be taken into account when calculating the numerator. |
| **Denominator**<br>**Base value** | The value on which the denominator of your custom ratio is based. The numerator and the denominator can be based on the same field or two different fields of the same type. The denominator can also be a constant (fixed value), which you enter when defining the custom ratio.<br>The available options for the denominator base value depend on the selected numerator base value:<br>> Macro (nested-table)<br>![image](media://ee1dd185-36fa-4017-8c3a-44de007e59eb) |
| **Denominator**<br>**JQL** | You can optionally define a JQL query to filter the issues contributing to the custom ratio's denominator. Only the issues that satisfy this query will be considered when calculating the denominator. |
| **Display format** | Specifies the format used to display custom ratios in the rich filter gadgets. The available options are:<br>- Percentage – for example, if the value is 3/10, the gadget displays 30%
- Ratio – for example, if the value is 3/10, the gadget displays 0.3<br>If the *Ratio* option is selected, you can further select how many decimals by selecting from 0 to 6 decimal places.<br>![image](media://5e7b0786-f81d-4d15-89ce-ac172270e678)<br>> ℹ️ Independent of this setting, custom ratios are always displayed as percentages in gauge gadgets. |

## > Macro (anchor)

Add and edit custom ratios

The *Custom ratios* section of your rich filter lets you perform the following operations:

### 1. **Add a new custom ratio**

1. Click the **Create custom ratio** button at the top-right of the page.
2. Type a **Name**, select a color, configure the **Numerator** and **Denominator**, choose the **Display format**, and click **Create**.

> ℹ️ You can add up to 100 custom ratios in each rich filter.

### **2. View or edit a custom ratio**

Click the **Edit** ()icon next to a custom ratio. to view or edit its configuration. Depending on your rights, you can edit or only view the queue.

![image](media://eef229b7-4699-40c8-99a2-f83ac11d0c2b)

### 3. **Reorder the custom ratios**

Hold the pointer over the queue's **Grid **() icon, then drag the custom ratio up or down to the new position.

![image](media://ad4382dc-f23b-41e9-921f-ac85e9ed2277)

### **4. Delete a custom ratio**

Click the **Delete** () icon next to the custom ratio.

![image](media://12621231-cdbd-4a97-acaf-15ce3b1a2992)

## > Macro (anchor)

**Use custom ratios in Rich Filter gadgets**

Below, we provide the list of rich filter gadgets that can display custom ratios:

- The **Rich Filter Simple Gauges** gadget displays gauges based on three custom ratios: *Completion rate, Work ratio,* and *SLA %Met*:

![SLA.png](media://ae6b3e86-0f0c-4f50-b636-9f6954a4fcf4)

Check the[ Rich Filter Simple Gauges Gadget](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783942228) documentation page to see how to configure the gadget.

- The **Rich Filter Smart Gauges** gadget displays for each team (defined in a [smart filter](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941713)) a gauge representing a custom ratio named *Work ratio*:

Check the[ Rich Filter Smart Gauges Gadget](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783942246) documentation page to see how to configure the gadget.

- The **Rich Filter Statistics** gadget displays two custom ratios, Completion rate, and Work ratio, aggregated by the issue field Priority:

![statistics custom.png](media://fb50daf3-a911-42c3-bf89-74bbed34dbbb)

<span style="color: #172b4d">Check the </span><span style="color: #172b4d">[Rich Filter Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941781)</span><span style="color: #172b4d"> documentation page to see how to configure the gadget.</span>


- The **Rich Filter Two**<span style="color: #172b4d">[-](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941781)</span>**Dimensional Statistics** gadget displays a custom ratio named *SLA %Met*, aggregated by the issue field Priority and a [smart filter](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941713) named Team:

![statistic custom ratio.png](media://02a4b463-4299-4aa0-8906-3778d1715cfa)

<span style="color: #172b4d">Check the </span><span style="color: #172b4d">[Rich Filter Two Dimensional Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941803)</span><span style="color: #172b4d"> documentation page to see how to configure the gadget.</span>

- <span style="color: #172b4d">The </span><span style="color: #172b4d">**Rich Filter Flexi Chart **</span><span style="color: #172b4d">gadget display</span><span style="color: #172b4d">[s](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941803)</span><span style="color: #172b4d"> the </span><span style="color: #172b4d">*Completion rate*</span><span style="color: #172b4d"> custom ratio broken down by assignees. </span>

![flexi chart with custom ratio.png](media://b5c912c4-6baa-4479-ae24-45b26b8babb1)

<span style="color: #172b4d">Check the </span><span style="color: #172b4d">[ Rich Filter Flexi Charts Gadget](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941863)</span><span style="color: #172b4d"> documentation page to see how to configure the gadget.</span>

- <span style="color: #172b4d">The </span><span style="color: #172b4d">**Rich Filter Time Series Chart **</span><span style="color: #172b4d">gadget displays two time series: </span><span style="color: #172b4d">*Work ratio*</span><span style="color: #172b4d"> and </span><span style="color: #172b4d">*Resolved issues.*</span><span style="color: #172b4d"> </span>

![time series chart.png](media://6adee2a6-3711-4920-9b94-7d468bd15574)

<span style="color: #172b4d">Check the </span><span style="color: #172b4d">[Rich Filter Time Series Chart Gadget](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783942364)</span><span style="color: #172b4d"> documentation page to see how to configure the gadget.</span>