> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stat card

> A single headline KPI number from your records.

## Overview

A **Stat card** reduces a whole object to one number: total deals, open tickets, average deal size, unique companies. It's the KPI tile you put across the top of a dashboard so the headline is readable at a glance, before the charts below break it down.

## When to use

* A single number is the point: "how many", "how much", "what's the average".
* As a dashboard's top row of KPIs, paired with charts that explain the trend behind each number.

## Configuration

| Setting     | What it does                                                                                     |
| ----------- | ------------------------------------------------------------------------------------------------ |
| Object      | The records the stat is measured over (required).                                                |
| Property    | The property to aggregate. Leave blank to count records; required for Sum / Average / Min / Max. |
| Aggregation | How the number is computed: Count, Unique, Sum, Average, Min, or Max.                            |

Scope the number with per-block filters, and connect a dashboard-level filter so the KPI moves with the rest of the board.

## Limitations

* **Count** and **Unique** ignore the Property; **Sum / Average / Min / Max** require a numeric Property, or the card reads 0 / blank.
* A stat card is a point-in-time number, for a trend, pair it with a [Sparkline](/bi/reporting/charts/sparkline) or [Line](/bi/reporting/charts/line) chart.

## Troubleshooting

| Symptom                                       | Likely cause                                                                  | What to check                                                         |
| --------------------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| The number is 0                               | No records match, or Sum / Average is set with no (or a non-numeric) Property | Check filters; pick a numeric Property for Sum / Average / Min / Max. |
| The number looks too high                     | Duplicate records inflate a Count                                             | Try **Unique** on an identifying property.                            |
| The card doesn't move with a dashboard filter | The dashboard filter isn't linked to this block                               | Link the block to the dashboard-level filter.                         |

## Related

* [Sparkline](/bi/reporting/charts/sparkline): the same measure as a compact trend.
* [Team performance](/bi/reporting/team-performance): many per-teammate stats in one table.
* [Reporting overview](/bi/reporting/overview)


## Related topics

- [Usage tracking](/bi/reporting/usage.md)
- [Views Overview](/surfaces/views/overview.md)
- [Saved Views](/surfaces/views/saved.md)
- [Business Intelligence](/bi/overview.md)
- [BI Best Practices](/bi/best-practices.md)