---
title: "Configure custom values"
canonical: "https://support.appfire.com/space/RFP/803405881/Configure%20custom%20values"
format: markdown
---
> Macro (aura-html)
## > Macro (anchor)
About custom values
Custom values are user-defined outputs used in rich filter gadgets and time series, just like the built-in values. The custom values add new options for value display (label, color, formatting) and support for total formulas (sum, average, min, max). They can be based on issue count, numeric and time tracking field values, or computed duration (resolution time & issue age). Also, the scope of the custom values can be further refined using JQL sub-queries.
Below is an example of a Rich Filter Statistics gadget that displays, by assignee, the following custom values: the sum of the story points of the resolved issues, the sum of the time spent for support issues, the average time spent (displayed in hours) and the maximum remaining estimate for the unresolved issues.
## > Macro (anchor)
Custom values key attributes
You can add new and see existing custom values and their key attributes in the **Custom Values** section of your rich filter.
The **key attributes** of a custom value are:
| **Attribute** | **Description** |
| --- | --- |
| **Name** | Each custom value has a name used to identify and display it. The name is mandatory and must be unique among the custom values within the rich filter. |
| **Color** | Optionally, you can set a custom color to display the value in some rich filter gadgets. |
| **Base value** | Select the value on which your custom value is based. Your custom value can be based on:
- Issue count
- Numeric fields
- Time Tracking fields
- Duration - computed values (see *[Duration (calculated) Custom Values](/wiki/pages/resumedraft.action?draftId=803405881#ConfiguringCustomValues-section5)* section below) |
| **Total formula** | The total formula is used when displaying totals for the custom values. Possible options are sum, average, minimum, and maximum values
 |
| **Display** | The display format of the custom value. The available options are
- For numeric fields:
- Thousand separators on/off
- Number of decimals: none or maximum 3, 2 or 1 or exactly 3, 2 or 1
- For time-tracking fields:
- Jira's time display format – uses the time format as configured in Jira by the administrator of the instance
- Days, hours, minutes, or seconds
> ✅ What's the difference between maximum 2 and exactly 2 decimals?
> ✅
> ✅ If you select the *exactly 2* option the value will always be displayed with 2 decimals. This is achieved by rounding to 2 decimals if more than 2 are available (e.g., 23.4567 → 23.46) or padding with zeros up to a total of 2 decimals if fewer than 2 are available (e.g., 23.4 → 23.40).
> ✅
> ✅ Selecting the maximum 2 option will display the value with 0, 1, or 2 decimals. This is achieved by rounding to 2 decimals if more than 2 are available (e.g. 23.4567 → 23.46) and leaving the value as it is if 2 or fewer decimals are available (e.g., 23.4 → 23.4). |
| **JQL filter** | You can optionally use a query to restrict the definition of this custom value to only a subset of issues. The custom value will be empty for the issues that do not satisfy this query. |
## > Macro (anchor)
Edit custom values
The **custom values** section of your rich filter also allows you do to the following operations:
| **To do the following:** | **Do this:** |
| --- | --- |
| **Add a new custom value** | 1. Click **Create custom value** at the top-right of the page.
2. Type a **Name**, select a color, **Base value,** **Total formula**, and a display format,
3. (Optional) Type a JQL query,
4. Click **Create**.
> ℹ️ You can add up to 50 custom values in each rich filter. |
| **View or edit a custom value** | Click the **Edit** ()icon next to a custom value to view or edit its configuration. Depending on your rights, you can edit or only view the custom value.
 |
| **Delete a custom value** | Click the **Delete** () icon next to the custom value name.
 |
| **Reorder the custom values list** | Hold the pointer over the queue's **Grid **() icon, then drag the custom value up or down to the new position.
This order is applied when displaying the custom values in the settings of the rich filter gadgets and the time series where they can be used. |
## > Macro (anchor)
Computed custom values
*Calculated custom values* are a special case of custom values having a computed base value. *Rich Filter for Jira Dashboards* provides two calculated custom values that represent time duration:
- **Issue age/resolution time*** - *predefined duration value calculated as the time elapsed between the resolution time (or now for unresolved issues) and the created date
- **Custom duration*** - *duration value calculated as the time elapsed between any two date/date time fields or between a date/date time field and now
These options are further detailed in the sections below.
### > Macro (anchor)
Issue age/resolution time
As its value type indicates, *Issue age/resolution time* is a computed duration value based on the issue created and resolved dates.
Here is how the *Issue age / resolution time *value is computed:
- for resolved issues – the value represents the number of days between the resolution date and the created date (resolution time)
- for unresolved issues – the value represents the number of days between now and the created date (issue age)
To create a custom value based on the issue age / resolution time, select the **Issue age / resolution time** option in the** Base value** drop-down menu. The option is available under the **Duration (computed)** category:
> ✅ ### Lead Time
> ✅
> ✅ You can combine the *Issue age / resolution time* base value with JQL sub-queries to build custom values that show only the resolution time or only the issue age. For example, if you wish to see the *lead time* of your resolved issues, you can add the JQL query *resolution *that is not* empty *to your custom value definition and use the *average* total formula. Your custom value will show the average resolution time of your resolved issues – called the *Lead Time*.
> ✅
> ✅ 
> ✅
> ✅ 
### > Macro (anchor)
Custom duration
*Custom duration* is a computed duration value, calculated as the time elapsed between any two date/date-time fields or between a date/date-time field and now.
To create a custom value based on a custom duration:
1. Select the* ***Custom duration **option in the **Base value** drop-down menu to create a custom value based on a custom duration.
The option is available under the **Duration (computed) **category:
2. Select the **Start** and **End**, which can be a date/date-time field or the **Current time***. *
If the selected date/date-time field can be empty, an extra checkbox becomes available in the selection window, allowing the current day to be used instead of an empty value:
## > Macro (anchor)
Use custom values in rich filter gadgets
Once defined, custom values can be used in rich filter gadgets the same way built-in values are. The gadgets display the custom values considering their attributes – label, color, total formula, value display (for time tracking fields) and JQL filter.
Below are some examples of rich filter gadgets configured to display custom values:
- The** Rich Filter Simple Counter **gadget displaying five custom values:
Learn more: [Rich Filter Simple Counter Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407081) to find out how to configure the gadget.
- The** Rich Filter Smart Counters **gadget
Learn more:[ Rich Filter Smart Counters Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407067).
- The** Rich Filter Statistics** gadget displaying four custom values aggregated by assignee:
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 value named Max rem. estimate aggregated by the issue field Priority and a [smart filter](https://appfire.atlassian.net/wiki/spaces/RFCDOC/pages/783941713) named Team:
Learn more: [Rich Filter Two Dimensional Statistics Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407105).
- The** Rich Smart Gauges **gadget displaying a custom value named SP avg aggregated by the issue field Priority:
- The** Rich Filter Results **gadget** **displays a view that contains a custom value based on Time Spent and formatted in hours.
Learn more:[ Rich Filter Results Gadget](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803407090)
> ✅ The display format settings can be very handy if you wish to display some numeric or time-tracking fields in a particular format, e.g., hours for a time-tracking field.
## > Macro (anchor)
Use custom values in time series
Once defined, the custom values can also be used in time series. If you're unfamiliar with time series, look at our [Configuring Time Series](https://appfire.atlassian.net/wiki/spaces/RFP/pages/803405886) section.
When creating or editing time series, you can select your custom values in the **Base value **field.
The time series have the same *value type* as the custom values on which they are based. For example, if your custom value is *Numeric *type, then your time series will also have the same value type.
Like any other time series, the time series based on custom values can be displayed as line charts with the *Rich Filter Time Series Chart* gadget or tables with the *Rich Filter Statistics* gadget.
