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

# Metric Widgets in Klaritics

> Metric widgets in Klaritics display single-value KPIs pinned from analyses. Use them to highlight key numbers on your dashboards at a glance.

Metric widgets surface a single key number on your dashboard. They are perfect for headline KPIs like daily active users, conversion rate, or average revenue per user. A metric widget draws attention to the most important figures without requiring your team to open a full analysis.

## When to use metric widgets

Use metric widgets when you want to:

* Highlight a top-line KPI that the whole team watches
* Track a target number against a goal or benchmark
* Give executives and stakeholders a quick health check

## How metric widgets work

A metric widget is created by pinning a single-value result from an analysis. The value can come from a count, a ratio, an average, or any other aggregation you define in the underlying analysis. The widget updates automatically when the analysis refreshes.

## Pin a metric widget

<Steps>
  <Step title="Create the analysis">
    Build an analysis that returns a single aggregated value, such as a total count or a computed ratio.
  </Step>

  <Step title="Pin to dashboard">
    Click **Pin to Dashboard** and choose the dashboard where the metric should appear.
  </Step>

  <Step title="Position prominently">
    Place the metric widget at the top of the dashboard or in a large tile so it is the first thing viewers see.
  </Step>
</Steps>

<Info>
  Metric widgets work best when paired with chart widgets that show the same metric over time. The metric gives the current value; the chart shows the trend.
</Info>

## Next steps

* [Widgets overview](/widgets/overview)
* [Chart widgets](/widgets/chart-widgets)