Simple KPI chart

Vitara provides a major KPI number as well as a smaller font number to highlight change or historical performance (for example, representation change from the previous quarter). This visualisation is perfect for expressing vital figures in VI Dashboards and Documents alike.


Metrics - 3 metrics, with a minimum of one required. The first metric M1 will be displayed as a large number (Main label), while the second metric M2 will be displayed as a smaller number (Sublabel). The third measure, M3, will be utilised to set background colour thresholds. Metrics can be regular or derived, and they can be formatted as %, Fixed, Currency, and so on.

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

By default, all three labels [main label, sub label, and title] on the Simple KPI chart are auto-scaled. The way the labels are scaled has changed as of version 4.3. So, if we modify the font-size of the Main label, the font-sizes of the Title and Sub label will be scaled proportionately. If you modify the font size for either the Sub label or the Title, the other two labels will not be auto-scaled. Take a look at the image below:


If you don’t want the Sub label and Title to be auto-scaled with the Main label font-size, just specify the font-size for Sub label and Title. If you want to return any font-size to the default auto-scale, just leave the font-size texbox empty. Take a look at the image below: autoScale2


In the KPI widget, you can set panel colours and icons using thresholds. Aside from the ‘Top Label’ and ‘Sub Label’ drop zones in the editor panel of a dossier, there is a third metric drop zone called ‘Threshold Metric’ that will be used exclusively 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.

When used in combination with small multiples, the basic kpi chart enables for the insertion of a distinct background image based on attribute in addition to the usual background image.


  • 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.


Since Version 5.1.2, a new tooltip option has been introduced. It can be found in the property editor’s below Data Labels tab, where users can add various macros based on the information they want to show in the tooltip box.

simpleKPI tooltip

simpleKPI tooltip