> For the complete documentation index, see [llms.txt](https://guides.tability.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.tability.io/docs/become-a-tability-power-user/features/kpis.md).

# KPIs

KPIs in Tability are reusable workspace metrics. They let you keep an ongoing history of actual values, compare performance with targets, and show the same metric in multiple plans or KPI Views.

{% hint style="warning" %}
KPIs and KPI Views are available on **Tability Premium** and during a Tability trial.
{% endhint %}

## KPIs and Key Results serve different purposes

Use a **KPI** when you want to monitor an important metric continuously, independently of a particular goal cycle. A KPI can be reused in several plans and Views without duplicating its data.

Use a **Key Result** when the metric represents a time-bound outcome inside a plan and is part of your regular goal check-in process.

Attaching a KPI to a plan does not turn it into a Key Result. It remains one shared KPI with one value history.

## What you can do with KPIs

* Track actual values by day, week, or month.
* Compare actuals with targets, or track a metric without targets.
* Add historical targets and actuals from a CSV file.
* Connect a KPI to a supported data source.
* Give the whole workspace, selected people, or selected teams access.
* Add the same KPI to multiple plans.
* Group KPIs into ordered, read-only timelines called Views.

## Understand the status dot

The dot beside a KPI gives you a quick indication of its latest status:

* **Green:** the latest value meets the target, based on the KPI direction.
* **Red:** the latest value does not meet the target.
* **Blue:** the KPI has a value but is not being compared with a target.
* **Grey:** there is not yet a numeric value to assess.

For a KPI that should go up, the value is green when it is greater than or equal to the target. For a KPI that should go down, it is green when it is less than or equal to the target.

## Get started

1. Open **KPIs** in your workspace sidebar.
2. Select **Create KPI**.
3. Enter the metric, choose whether to track a target, and set its workspace access.
4. Open the KPI to add values, targets, an owner, a description, or a data source.
5. Add it to a [KPI View](/docs/become-a-tability-power-user/features/kpis/kpi-views.md) or [show it alongside a plan](/docs/become-a-tability-power-user/features/kpis/add-kpis-to-plans.md).

## KPI guides

* [Create and manage KPIs](/docs/become-a-tability-power-user/features/kpis/create-and-manage-kpis.md)
* [Update KPI values and targets](/docs/become-a-tability-power-user/features/kpis/update-values-and-targets.md)
* [Manage KPI access](/docs/become-a-tability-power-user/features/kpis/manage-kpi-access.md)
* [Create and use KPI Views](/docs/become-a-tability-power-user/features/kpis/kpi-views.md)
* [Add KPIs to plans](/docs/become-a-tability-power-user/features/kpis/add-kpis-to-plans.md)