> 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/add-kpis-to-plans.md).

# Add KPIs to plans

Add a KPI to a plan when the metric provides useful operating context for the goals in that plan. The plan displays a KPI card with its latest value, status, last update, and description.

The attachment reuses the workspace KPI. Updating it from the KPI panel updates the same KPI everywhere it appears.

## Add a KPI

1. Open the plan's tracking view.
2. Find the **KPIs** section.
3. Select **Add KPI**.
4. Search for a KPI you can view.
5. Select the KPI and add it.

You need edit access to the plan and at least view access to the KPI. A KPI can be attached to multiple plans.

## Open a KPI from a plan

Select its KPI card to open the full KPI panel. What you can do next depends on your KPI permission:

* KPI editors can change values, targets, settings, ownership, and data sources.
* KPI viewers can inspect its history but cannot change it.

## Remove a KPI from a plan

If you can edit the plan, use the remove action on the KPI card and confirm the removal.

{% hint style="info" %}
Removing the attachment does not delete the KPI, its history, or its attachments to other plans and Views.
{% endhint %}

## Plan and KPI permissions are independent

Access to a plan never grants access to its KPIs automatically:

* Plan viewers see only attached KPIs they are allowed to view.
* A plan editor cannot attach a KPI they cannot view.
* Someone may be able to edit a plan but have view-only access to an attached KPI.
* Someone may be able to edit a KPI but have view-only access to the plan.

Manage plan permissions and KPI permissions separately so the intended audience can see both layers.

## KPI availability

The KPI section appears in plans only for workspaces with KPI access. KPIs and KPI Views are available on Tability Premium and during a Tability trial.