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

# Count

> Displays a formatted numeric value with optional unit and status styling for KPIs, metrics, and summarized quantities.

## Count

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-count--docs)

### When to use

* When a single numeric value (with optional unit) is the primary information — totals, rates, percentages, or live readings.
* In card headers, summary rows, or metric tiles where space is limited.
* When status coloring helps users interpret whether a value is within an expected range.

### When to use something else

* For labeled metadata or filters, use [Badge](/aura-design-system/primitives/badge).
* For full trends or multi-point comparisons, use [Chart](/aura-design-system/primitives/chart).
* For tabular detail across many fields, use [Data grid](/aura-design-system/primitives/data-grid).

### Behavior

* Format numbers for locale and precision appropriate to the domain (decimals, units, grouping).
* Use status variants only when the semantic meaning is clear to users.

### Often used with

* [Card](/aura-design-system/primitives/card), [Chart](/aura-design-system/primitives/chart), [Tabs](/aura-design-system/primitives/tabs), [Segmented control](/aura-design-system/primitives/segmented-control).