# KPI card

KPI cards in Biuwer allow for the visual representation of totalised numerical values. They are usually used in pages to compose dashboards and their purpose is to serve as a summary.

![Example of KPI cards in Biuwer](/files/-MMUnpgTXtMkwwQluaGc)

A KPI card **supports multiple queries**, so that as many total numeric values as needed can be incorporated into the same card. However, regardless of this, when configuring the card, **only metric type fields are supported**, to which an aggregation function has been applied, in order to obtain a single total value.

To configure the display of a KPI card, from the "Visualization" tab of the Data Card Editor:

1. Select one or more metric type fields from the "Available fields" and drag it to the "**Indicator location**" block on the right.
2. Press the "Preview" button to show step-by-step how the card is displayed.
3. You can configure different **layouts** for the location of various metrics.

![Configuring a KPI card in Biuwer](/files/-MMUqXeVkodZJ4zhAfQu)

Using the pencil icon on each metric you access the indicator settings with multiple options:

* **Configuration**. You can indicate the **vertical position** of the indicator, its **numerical format** and **visual style**. You can also specify an **icon** among the catalog of available icons and if it is a **time metric**, that is, it measures a temporary duration, you can specify what it means (seconds, minutes, hours, days, etc.) and what time format you want to use. In addition to the indicator, you can **display a text** around it indicating a particular visual format, even with a custom icon.

![Options for setting up an indicator on a KPI card](/files/-MMUooFJQ-tZXaFIBfYv)

* **Box style**. You can specify a **background color, borders** and even **indentation**, for each of the four sides of the box.

![Applying box styles to an indicator on a KPI card](/files/-MMUp34ofERGOJNwZ0U-)

* **Conditional style**. It is possible to specify one or more conditional styles, based on arithmetic conditions that the indicator value reaches. For each added condition it is possible to apply again a totally different configuration and box style, in all its parameters.

![Applying conditional styles to an indicator on a KPI card](/files/-MMUpJhptSSdEf5GEdBh)

Below is a visual example of a KPI applying other styles and formats.

![Example of a KPI card with applied formats](/files/-MMUphJBH1kmFjmtcSql)


---

# 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.biuwer.com/content-management/cards/kpi-card.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.