Simple KPI chart

Vitara offers a headline KPI number and a smaller font number to show change or past performance (for instance, for representation change from the previous quarter). This visualization is ideal for representing key figures that need to be highlighted in VI Dashboards and Documents alike.


Metrics - 3 Metrics, min 1 required. The first metrics M1 will be shown as the big number (Main label) and the second metric M2 will be shown as the smaller number (Sublabel). The third metric M3 will be used to create thresholds for background colors. Metrics can be regular or derived metrics and can be formatting as %, Fixed, Currency, etc.

Attributes - Optional Use as Filter Option - Not available


The screenshot below showcases the KPI widgets formatted with different colors of text and also using metric values formatted as currency and % respectively. By default KPI widget will show the name of the first metric (Main label) as the title of the widget, but we can modify this with our own text input in Appearance ? Text Label ? Label-text input box.

simpleKPI inputs

KPI widgets can be effectively combined with VitaraCharts’ Sparkline to show the trend of the key number for the executive dashboard. See the example below.

simpleKPI inputs

Autoscaling the labels

In Simple KPI chart, by default all three labels[i.e main label, sub label and title] are auto-scaled.
From 4.3 version, the way the labels are scaled is changed. So, if we change the Main label font-size, then the Title and Sub label font-sizes will be scaled accordingly. And the other two labels will not be auto-scaled if you change the font-size for either Sub label or Title. See the screenshot below:

And if you dont want the Sub label and Title to be auto-scaled with Main label font-size specified, then just specify the font-size for Sub label and Title
And if you want to reset any font-size to default auto-scale, then just make the font-size texbox empty. see the screenshot below:


You can apply thresholds to set panel colors and icons in the KPI widget. For Simple KPI chart, in the editor panel of a dossier, apart from the ‘Top Label’ and ‘Sub Label’ drop zones, there is a third metric drop zone called ‘Threshold Metric’ which will be used specifically for applying thresholds in Simple KPI chart.

simpleKPI thresholds1

Open the property editor by clicking on the ‘Edit’ button and select the ‘Threshold’ tab. In the threshold, the editor window applies source, target, threshold condition, and other related information. In the below screenshot, for Simple KPI charts panel colors and icons are set using thresholds.

simpleKPI add thresholds

simpleKPI thresholds editor

simpleKPI thresholds2

Background Image

The steps to set a background image for all Vitara charts are explained in backgroundImage.

In addition to the standard background image, the simple kpi chart allows for adding a different background image based on attribute when used in conjunction with small multiples.


  • Drag attribute into Small Multiple.
  • Add the name of the attribute in background Image path: &[Category].gif (jpg and png are also supported)

simpleKPI attr background

  • Add the images in images folder (Tomcat\webapps\MicroStrategy\plugins\VitaraCharts\custom\images) with names as the value of Category like books.jpg, electronics.jpg, music.jpg etc
  • The names of the images should be in lowercase letters. For example, movies.jpg.
  • As a result, you will find each small multiple plot with respective image.

simpleKPI attr background

Small Multiples

Simple KPI chart supports small multiples feature. Small multiples feature is explained in smallMultiples.