# Stat Card > A KPI tile with a value, a trend badge and a caption. Source: https://shellui.dev/docs/v0.4/components/data-display/stat-card `StatCard` is **new in v0.4**. It shows one metric: a title, the value, an optional change badge coloured by trend, and a description. ## Installation ```bash shellui add stat-card ``` ## Usage ### Basic ```razor
``` ### Trends `Trend` colours the `Change` badge: `up` is green, `down` is red, and anything else is neutral. It doesn't read the sign of `Change`, so a falling error rate can still be `up` if that's good news. ```razor
``` ### With an icon ```razor
``` ### Extra content Anything inside the card renders below the description. ```razor
``` ## API Reference | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `Title` | `string?` | `null` | The metric's name | | `Value` | `string?` | `null` | The value, already formatted | | `Change` | `string?` | `null` | Text for the badge, such as `+20.1%` | | `Trend` | `string` | `"neutral"` | Badge colour: `up`, `down` or `neutral` | | `Description` | `string?` | `null` | Caption under the value | | `Icon` | `RenderFragment?` | `null` | Icon in the top-right corner | | `ChildContent` | `RenderFragment?` | `null` | Content below the description | | `Class` | `string?` | `null` | Additional CSS classes | ## Accessibility - Trend is shown by colour only, so keep the sign or a word in `Change` (`+20.1%`, `down 4%`) - Decorative icons need no label; give a meaningful icon an `aria-label`