--- title: "Configure custom ratios" canonical: "https://support.appfire.com/space/RFP/803406522/Configure%20custom%20ratios" format: markdown --- > Macro (aura-html) ## > Macro (anchor) About custom ratios Custom ratios are computed user-defined outputs that are 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 or 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 Gauge* gadget that displays two gauges based on two custom ratios: *Completion rate* and *Work ratio*. ![image](media://acb10201-1ebe-4b29-ae37-944cd3b3c663) ## > 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. ![2025-09-04_08-30-36.png](media://3421796d-7de6-4e12-a07c-e7aefac0834e) 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 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.
![Numerator Base value](media://de719aec-a551-4cea-8c39-02ee193b8de0) | | **Numerator JQL** | You can optionally define a JQL query to filter the issues contributing to the custom ratio's numerator. Only the issues that satisfy this query will be considered when calculating the numerator. | | **Denominator 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 on two different fields of the same type. The denominator can also be a constant (fixed value), which you enter when defining the custom ratio.
The available options for the **Denominator Base value** depend on the selected numerator base value:
> Macro (nested-table)
![Denominator Base value](media://8f297a0c-97b9-4e99-bcfa-d7af723160d7) | | **Denominator JQL** | You can optionally define a JQL query to filter the issues which contribute to the denominator of the custom ratio. Only the issues which satisfy this query will be taken into account when calculating the denominator. | | **Display format** | Specifies the format used to display custom ratios in the rich filter gadgets. The available options are:
- 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
If the *Ratio* option is selected, you have the possibility to further select how many decimals to display: none or exactly 3, 2 or 1 decimals.
![Display format](media://004d8df8-98a9-4d5f-b91b-fd96ded4cc53)
> ℹ️ Custom ratios are always displayed as percentages in gauge gadgets, independently of this setting. | ## > Macro (anchor) Edit custom ratios The **Custom ratios** section of your rich filter also lets you perform the following operations:  | **To do the following:** | **Do this:** | | --- | --- | | **Create a new custom ratio** | 1. Click **Create custom ratio** button at the top-right of the page.
![image](media://59bb401d-38ab-4ec0-a50e-270548105b48)
2. Type a **Name**, select a color, configure the **Numerator** and **Denominator**, and choose the **Display format**. 3. Click **Create**.
![Create a new custom ratio](media://285d560f-1f21-4178-bff0-f2a43f91b10f)
> ℹ️ You can add up to 50 custom ratios in each rich filter. | | **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.
![2025-09-04_09-22-38.png](media://ae3c597f-371f-4703-a2b5-cb843e21aafa) | | **Delete a custom ratio** | Click the **Delete** () icon next to the custom ratio.
![Delete a custom ratio](media://1fe93bbc-1066-400f-8d11-ab071b3215aa) | | **Reorder the custom ratios list** | Hold the pointer over the queue's **Grid **() icon, then drag the custom ratio up or down to the new position.
![Reorder the custom ratios list](media://8414bdeb-3b00-478f-b311-22b1e2b55fa0)
This order is applied when displaying the custom ratios in the settings of the rich filter gadgets. | ## > Macro (anchor) Use custom ratios in Rich Filter gadgets Once defined, the custom ratios can be used in the rich filter gadgets that support them. Below, we provide the list of rich filter gadgets that can display custom ratios: - The** Rich Filter Simple Gauge **gadget displays gauges based on three custom ratios: *Completion rate, Work ratio,* and *Highest priority ratio.* Learn more: [Rich Filter Simple Gauge Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407075). - The** Rich Filter Smart Gauges **gadget displays for each team a gauge representing a custom ratio named *Work ratio*: Learn more: [The Rich Filter Smart Gauges Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803406976) - The** Rich Filter Statistics **gadget displays two custom ratios, Completion rate, and Work ratio, aggregated by the issue field Priority: Learn more: [Rich Filter Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407113). - The** Rich Filter Two Dimensional Statistics **gadget displays a custom ratio named *Completion rate*, aggregated by the issue field Priority, and a smart filter named Team: Learn more: [Rich Filter Two Dimensional Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407105).