# KPI Tile

A **KPI Tile** is a compact visualization designed to display a **single key metric** such as a **sum, average, or aggregated value**. KPI Tiles are widely used in **dashboards, scorecards, and performance monitoring systems** to track **ongoing evaluation** of business-critical measures. By using **labels, colors, and formatting options**, KPI Tiles provide at-a-glance visibility into **Key Performance Indicators (KPIs)**.

### When to Use a KPI Tile

Use a **KPI Tile** when you want to:

* Present a **single high-level number** (e.g., revenue, expenses, conversion rate).
* Track **real-time KPIs** in operational dashboards.
* Display **progress against targets** in a concise, visual format.
* Summarize data for executives who need quick decision-making insights.

**Examples:**

* Sum of **Monthly Sales** in INR.
* **Customer Satisfaction Score (CSAT)** is displayed as a percentage.
* **Active Users** count for a digital platform.

### Chart Properties

#### General Settings

* **Label** – Enter the text label for the metric (e.g., *Total Revenue*).
* **Label Color** – Choose a color for the label.
* **Label Font Size** – Adjust the font size of the label.
* **Value Color** – Choose a color for the numeric value.
* **Value Font Size** – Adjust the font size of the displayed metric.
* **Exclude Global Filter** – Exclude this KPI from global filters applied at the report level.

#### View Filter

* **Filter** – Apply conditions to restrict the dataset shown in the KPI (e.g., filter by region or timeframe).

#### Primary Value Axis

* **Format Type** – Choose formatting style: None, Auto, Percent, Thousand, Lacs, Crore, Million, Billion, Trillion, Quadrillion.
* **Currency Type** – Add a currency symbol: None, Rupees, Euro, Pound, USD, Yen, Cent.
* **Precision** – Define decimal precision (up to 5 places).

**Example:** Display the **Sum of Monthly Salary in INR**, formatted in **Thousands**, with **Precision** set to 0 for whole numbers.

### Best Practices

* Use **consistent label naming** across KPIs in a dashboard for clarity.
* Apply **currency and precision** formatting that matches the business context (e.g., financial KPIs in Rupees with 2 decimal places).
* Keep KPI Tiles **minimalist**—focus on the most critical value rather than cluttering with details.
* Use **color coding** (green for good, red for poor performance) for intuitive interpretation.


---

# 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.bdb.ai/bdb-user-documentation/platform-modules/10.0/bdb-visualization/self-service-reports/chart-gallery/kpi-tile.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.