> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/command/features/measures.md).

# Measures

Record, trend and total the numbers you track on your records, such as cost, headcount or risk, with actual and planned values side by side.

Measures are the numbers you track on your records: cost, headcount, users, risk, or any figure you define. One model sits behind all of them, so every measure can be recorded over time, totaled across a portfolio and compared between actual and plan. A missing value is always shown as missing, never as zero.

## What it is

| Concept       | What it means                                                                                                                                                                       |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Measure**   | What is being measured, with its unit. Related measures are grouped into families and subtypes.                                                                                     |
| **Value**     | The number recorded for a measure on a record, for a period.                                                                                                                        |
| **Reference** | Which kind of value it is, such as **Actual**, **Planned** or **Budget**, so actual and plan sit side by side.                                                                      |
| Over time     | Values are recorded per period, so a measure can be charted and trended.                                                                                                            |
| Total         | A measure can be totaled across many records: summed, averaged, counted, or its lowest or highest value. Costs are summed and KPIs averaged unless an administrator sets otherwise. |
| Coverage      | Every total says how many records have data, so a partial total is never mistaken for a full one.                                                                                   |

## When to use it

* You track cost, users or another figure per application and want the portfolio total.
* You want to compare planned against actual over time.
* You model a change in a scenario and want to see its effect on cost.
* A score, a framework check or a visual needs a number to work from.

## How to

### Enter values on a record

1. Open the record as a [Form](https://docs.ins-pi.com/command/the-portal/content-types.md#form) and click **Edit**. You need the Command editor role.
2. Go to the **Measures** section and choose the **Value reference**, for example actual or planned, and the period: **Month**, **Quarter** or **Year**.
3. Click **+ Add measure** and search for a measure, or **+ Add date** to add a period.
4. Type the values in the grid, as in a spreadsheet: click a cell and type, press **Enter** to move to the next date. Drag a cell's corner to fill it across dates, or double-click the corner to copy it to every date.
5. Click **Save** on the Form.

Changed cells are marked until you save; point at one to see its earlier value. A value shown faded is carried forward from an earlier date, not entered for this one.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-114ae356de387263367eea5774ee85567cfb9ada%2Fcommand-form-measures.png?alt=media" alt="The Measures section of a Form, with a chart for one measure and the grid of yearly values for each measure on the record."><figcaption><p>The Measures section of a Form</p></figcaption></figure>

Calculated measures, and measures such as OPEX and CAPEX that hold the amount booked in each period, are read-only.

### See values from earlier dates

The **Measures** section opens on today's dates. If the record has values only on earlier dates, it opens on the most recent of those instead, and shows **Back to today**.

1. Open the record as a [Form](https://docs.ins-pi.com/command/the-portal/content-types.md#form). You don't need to click **Edit**.
2. In the **Measures** section, choose the measure in the list above the chart.
3. If the chart says there are no values between the shown dates, click **Show dates with values**. The dates move to that measure's most recent values.
4. To return to today's dates, click **Back to today**.

### Enter a cost in another currency

1. Open the record as a [Form](https://docs.ins-pi.com/command/the-portal/content-types.md#form) and click **Edit**.
2. In the **Measures** section, choose the cost measure in the list above the chart.
3. In the currency list beside it, choose the currency you want to type in. You can change it only while that measure's row has no saved values.
4. Type the values in the grid and click **Save** on the Form.

Command converts each value into the measure's currency when it is saved, at the exchange rate for its date. The row then reads **Entered in** and your currency, and shows the amounts as you typed them; totals use the converted amounts. Point at a value to see what it was saved as.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-d717c7c5c71fcf18d8d29dc0b9ce47144a2fad05%2Fcommand-form-measures-currency.png?alt=media" alt="The Measures section of a Form, with a currency list beside the selected cost measure and its grid row entered in US dollars."><figcaption><p>Entering a cost in another currency</p></figcaption></figure>

### Total measures across your content

1. In a Table, Gravity Map, Hierarchy Map, Scenario or TIME Analysis, open the content's **⋮** menu and switch on the **Metric** panel.
2. Click **+** (**Add or manage measures**) and pick measures in **Select measures**, or switch on **Automatically add** to show every measure with data.
3. Read each card's total and how many records have data. Click a card to filter to the records that have that measure. The active card says how many records it shows, such as *9 of 12*; click it again to remove the filter.
4. Switch on the **Timeline** panel and drag the **Time** scrubber, or click **Today**, to see the values for another period.

<figure><img src="https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-ad16c358a3e6c4375ea124188f7df551b973a336%2Fcommand-measures-metric-panel.png?alt=media" alt="A Static List of business applications with the Metric panel above it, showing a Cost Savings card totaled with SUM, and the Timeline scrubber at today."><figcaption><p>Totals in the Metric panel</p></figcaption></figure>

### Use measures elsewhere

* **Table:** add measure columns from the **Measures** category in **Columns**.
* **Dashboard:** add a **Measure gauge**, **Measure trend** or **Record measures** widget.
* **Scenario:** set a what-if value for a measure on a record in that scenario only, then compare **Baseline**, **Scenario** or **Scenario vs Baseline**. Reset a what-if to fall back to the baseline value. To type cost what-ifs in another currency, choose it in **What-if currency**; each value is converted into its measure's currency when you enter it.

## Good to know

* A record without a value is left out of a total, never counted as zero. A card or cell with no data shows a dash or **no value**.
* A cost booked per period, such as OPEX or CAPEX, counts only in its own period. At a quarter's stop on the **Timeline** you see that whole quarter; at **Today** you see the quarter so far.
* Administrators define measures, families, subtypes and references in **Global Settings > Measures**.
* Every cost measure has one currency, and totals never add different currencies together. Administrators choose the currencies and exchange rates; see [Currencies for measures](https://docs.ins-pi.com/command/administration/measure-currencies.md).
* Measures feed [Scoring](https://docs.ins-pi.com/command/features/scoring.md), the [Framework Intelligence Center](https://docs.ins-pi.com/command/features/framework-intelligence-center.md) and visuals such as the Gravity Map and TIME Analysis.
* [Data Governance](https://docs.ins-pi.com/command/features/data-governance.md) can check that the measures that matter are filled in.

{% hint style="info" %}
If a total looks low, check how many records have data before you rely on it.
{% endhint %}

## Related

* [Scoring](https://docs.ins-pi.com/command/features/scoring.md)
* [Future State Repository](https://docs.ins-pi.com/command/features/future-state-repository.md)
* [Content Types](https://docs.ins-pi.com/command/the-portal/content-types.md)
* [Currencies for measures](https://docs.ins-pi.com/command/administration/measure-currencies.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
