# KPI Management

A KPI is a Key Performance Indicator used to measure the performance of a Portfolio Element.

## Defining KPIs

Open the YouDesign Command Settings -> KPIs table from the Application Menu.

**A** – To define a new KPI, press the New button.

**B** – Shows the KPIs defined.

![](/files/vl3DFYfneD3h0wYeCC5s)

## KPI Definition Form

Creating KPI definitions is straightforward.

{% hint style="info" %}
**KPI Breakdown Values**

KPI Breakdowns must be entered as numbers to produce reports and enable comparisons. The description should include an overview of allowed values and their meaning (for example, 10 = high, 1 = low).
{% endhint %}

**A** – Enter a short name for the KPI.

**B** – Enter a brief description of the KPI.

![](/files/jTlp1KqqJ1uHG88wYstA)

## KPI Section – Defining KPI Breakdowns

KPI Breakdowns are the instances of KPIs with the real values. The KPI section allows users to define KPI Breakdowns and visualize the data.

**A** – KPI Overview Report showing average values per KPI.

**B** – KPI Breakdowns

**C** – Double-click the "Insert a new row\..." field to select and enter information for a specific KPI Breakdown.

* Name – Select a descriptive name to distinguish it from other KPI Breakdowns. Planned and Actual KPI Breakdowns should have the same name.
* KPI – Select a defined KPI.
* KPI Reference – specifies the nature of the KPI Breakdown.
  * Actual – The actual value of the KPI Breakdown, typically measured as of today.
  * Baseline – The starting value or industry-specific reference value (for example, APQC process KPI).
  * Planned – The target value to be achieved within a specific timeframe.

![](/files/H7mSF6AB6uHhl1zGUmo6)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ins-pi.com/command/features/kpi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
