How to Set a Custom Colour for a KPI Dashboard Tile

Summary of the Issue
When creating or updating a KPI dashboard tile, the desired colour may not appear in the available options. To use a specific colour, it must first be added to the list of selectable colours via INI settings.

Resolution Steps
To configure a custom colour for a KPI dashboard tile:

1. Find the hex code of the colour you want to use

   • Use an online colour picker tool such as htmlcolorcodes.com to select your preferred colour and copy its hex code (e.g. #8BC34A).

2. Update the list of selectable colours

   • Go to System → Settings → INI Codes.

   • Search for the setting:
     COLOURPICKER:KPI:AVAILABLE_COLOURS

   • Add your chosen hex code to the value, separated by commas if other colours are already listed.
     Example: #009900,#FF0000,#8BC34A

   • Save the setting.

3. Apply the colour to your KPI tile

   • Open your KPI dashboard and edit the relevant tile.

   • Use the colour picker to select the newly added colour.

   • Save the tile.

Additional Notes

• The setting COLOURPICKER:KPI:AVAILABLE_COLOURS controls which colours are shown in the picker.

• The following optional INI settings define default colours:

  • COLOURPICKER:KPI:GREEN

  • COLOURPICKER:KPI:RED

  • COLOURPICKER:KPI:YELLOW

• These default colour settings are used when no colour is explicitly selected.

• No code changes are required. This is a configuration-only change.

• Access to INI Codes may require admin permissions.