# Configure visualization

Depending on the selected data structure, you need to map a few fields to configure the visualization.

### KPI Dimension (and parent KPI dimension)

For **Grid layout options 1 & 2**, map the relevant KPI dimension (e. g. 'Segment' if you want to create a card for each segment). If you want to create KPI cards for combinations of for example two dimensions (e. g. 'Segment' and 'Region'), create a calculated field first and concatenate the two fields (e. g. \[Segment]+" | "+\[Region]) and use this field as your KPI dimension.

For **Tree layout option 1,** additionally set the **parent KPI dimension**.

<figure><img src="/files/P9cpBE5LquSYXKwpNGB7" alt=""><figcaption><p>Configure Visualization for tree-option 1</p></figcaption></figure>

### KPI values

PowerKPIs can cope with different ways of storing different **scenarios**.&#x20;

When different scenarios (such as Actual, Budget, and Forecast) are stored in different columns (for example, in the Option 3 grid layout), **Measure Names** is the field that defines the scenarios.&#x20;

* Adjust the **KPI Card** label to group measures into one card.
* Adjust the **Measure Name** to show custom labels for your scenarios.
* Set the **Role BAN** to map scenarios to the main big number (Main), or to two optional comparison values (Comp 1 and Comp 2).
* Set the **Role Chart** to map scenarios to be used in the trend chart (Main and Comp 1).
* Additionally, an auto-generated **comparison to the previous value** is shown in most layouts.

<figure><img src="/files/vOaOMqev30FWIGSIJIhn" alt=""><figcaption><p>Configure KPI Values with Measure Names</p></figcaption></figure>

If different scenarios are stored in a **dimension** (e.g. in Option 4 Grid Layout), this dimension in combination with Measure Names is the field that defines the scenarios.

You can also customize labels and define roles for each of these options.

* **Map the scenario field** to define the KPI values.
* **Bulk assign roles** to the scenario field values.&#x20;
* Adjust the **Scenario & Measure** to show custom labels for your scenarios.

<figure><img src="/files/Dl1BWqq7TdVA4gTk1LJ9" alt=""><figcaption><p>Configure KPI Values with Scenario Dimension</p></figcaption></figure>


---

# 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.infotopics.com/powerkpis/configuration/configure-visualization.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.
