Document toolboxDocument toolbox

Configuring an Issue Score field

Open Issue Score field configuration


  1. Choose  > Issues
  2. Select Fields > Custom Fields to open the Custom Fields page.
  3. Navigate to the Custom Fields page, locate the desired custom field and choose cog icon >Configure.
  4. Locate Range and Formula and click the Edit Range and Formula link.



Configure Formula


In the Custom field formula input field, you can specify a formula to calculate the value of the Score field. Basically, the other half of the equation should be defined here by a mathematical expression: Score = [your custom field formula]

  1. Use custom field names between quotation marks as parameters. You can also search for a field based on its name or ID and add it to the formula with the "Add" button. 
    1. Custom field names in the formula field are case sensitive
    2. You can only use fields or custom fields that are number type fields. (Or returning with a number value.)
      1. Eg.: number field, another Issue Score field, the app's Key-Value field, calculated field by a 3rd party app, etc.
  2. You can use operands in your formula as: + - * / ( ) 
  3. Determine here a math equation, the result of which will be the value of the Score. There can only be one result of the equation (there can be no partial result in the equation).
    1. (tick) Good: (("CF1" + "CF2") / ("CF4" + "CF5"))
    2. (error) Bad: "CF1" + "CF2" = "CF3". "CF4" + "CF5" = "CF6". "CF3" / "CF6"

(warning) The score field will be visible if all the (custom)fields involved in the calculation have a value. Otherwise, it will not be present on the Issue screen or the configured default value will be displayed.

Add Default Value


You can define a default value for the Score fields. The default value of the score field when it is first displayed to a user or if the calculation cannot be performed.

Display range name


Check this to display the name of the range in which the calculated number falls, instead of the result number.

Score calculation behavior


If enabled, Score will be calculated only if the custom field values in the formula have changed in the Issue. (This is the default behavior.)

When disabled, Score is calculated for each event in a given Issue, but this may slow down your system.


Configure Ranges


The results of the calculation can be divided into ranges. You can display the result numbers in different ranges with a different color on the Issue page.

The configured ranges will be displayed on the top of the page as a table.

Adding a range

  1. Define the name of the range
  2. Define the minimum value of the range. The range is a left-closed interval, it contains a min value.
  3. Define the maximum value of the range. The range is a right-opened interval, it does not contain a max value.
  4. Select a background and a text color for the range. The result numbers will be displayed based on this color configuration.
    1. You can see in the "Preview" field how the score will look like.
  5. A new range can be added using the "Add" button.
  6. You can also edit or delete the ranges.


Display Score on your Issues


Add your Score field to your Issue Screens, card layouts or Issue detail views.