# KPIs

## Overview

**KPIs add an aggregated metric to a chart** to provide a high-level view metric, a baseline, or any other extra information. It can be a numerical value or some text.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-1c87eddbd0dd0026523decbf12a385df02e937f2%2Fstory-with-hkpi.png?alt=media" alt="A story including a KPI"><figcaption><p>A story including a KPI</p></figcaption></figure>

{% hint style="info" %}
💡 **Pro Tips**

* KPIs can also be linked to filters
* KPIs can be used with a [crossfilter](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/stories/crossfilter "mention") from the parent chart if they use the same dataset
* You can drag & drop KPI to change the display order
  {% endhint %}

{% hint style="warning" %}
**You can add up to 3 HKPIs in one story.** Consider using a dedicated visualization such as a scorecard to show more KPIs.
{% endhint %}

## Configuration

<table><thead><tr><th width="144.33333333333331">Section</th><th width="246">Option</th><th>Configuration tutorial</th></tr></thead><tbody><tr><td></td><td>Dataset (mandatory)</td><td>Select the dataset used by the KPI</td></tr><tr><td></td><td>Value (mandatory)</td><td>Choose the column name containing the value to display</td></tr><tr><td></td><td>Text (optional)</td><td>Add a text to contextualize your KPI</td></tr><tr><td>Other options</td><td>Badge</td><td>Tick to be able to add context such as an additional value or an evolution</td></tr><tr><td>Other options</td><td>Badge - Value</td><td>Column name containing the badge value. Define its and linked symbol. Default to up/own arrow.</td></tr><tr><td>Other options</td><td>Badge - Text</td><td>Add a text to contextualize your badge</td></tr><tr><td>Other options</td><td>Icons choices</td><td>Pick an icon to highlight the related sentiment. Important: configure a sentiment before choosing an icon (<a data-mention href="../../creating-visualizations/advanced-chart-configuration/add-units-precisions-and-sentiments">add-units-precisions-and-sentiments</a>)</td></tr><tr><td>Other options</td><td>Reverse display order</td><td>Toggle to display first the <code>text</code> and then the <code>value</code></td></tr></tbody></table>

{% hint style="info" %}
You can add units, precision, and sentiments. To know more about this watch here:[add-units-precisions-and-sentiments](https://docs-v3.toucantoco.com/visualizations-and-layouts/creating-visualizations/advanced-chart-configuration/add-units-precisions-and-sentiments "mention")
{% endhint %}