# Number Widget
### What is the Number Widget?
The Number widget is a widget type available in Birdie Dashboards. Rather than plotting data on a chart, it displays a single metric as a large, prominent number, making it ideal for surfacing key figures at a glance. It also supports a **secondary metric** displayed beneath the primary value, allowing you to add context directly to the widget without needing a separate element.
The Number widget is the simplest and most focused widget type in Birdie. It has no breakdown, no axes, and no series, just one or two metrics rendered clearly on the dashboard.
#### How to extract the most value from the Number Widget?
Use the Number widget when a single figure is the most important thing a viewer needs to see. It works best for headline metrics that anchor a dashboard and give immediate context to the charts around them. For example:
* What is the total number of feedback responses received in the last 30 days?
* What percentage of all responses does a specific area represent across the organisation?
* What is the current overall CSAT or NPS score?
Pairing a primary metric (such as a raw count) with a secondary metric (such as a percentage of total) gives viewers both the absolute figure and the relative context in a single compact widget.
### Setting up a Number Widget
{% stepper %}
{% step %}
#### Select the widget type
When adding a new widget to your dashboard, select **Number** from the widget type options at the top of the configuration panel.
{% endstep %}
{% step %}
#### Add a title and subtitle
In the **Title** field, enter a clear name for your widget. You can also add an optional **Subtitle** to provide additional context for other users viewing the dashboard.
{% endstep %}
{% step %}
#### Configure the data
Navigate to the **Setup** tab to define the metrics the widget will display.
* **Primary metric**: Select the main metric to display as the large headline figure. For example, choose **Overall** to show the total count of feedback responses within the selected date range.
* **Secondary metric**: Optionally, select a second metric to display beneath the primary value. This appears as a smaller supplementary figure and is useful for adding proportional or contextual information. For example, selecting **Overall: % Count over organization (All responses)** will show what percentage of total organisational responses the primary count represents.
{% hint style="info" %}
The secondary metric is optional. If you only need to display a single figure, leave the secondary metric field empty.
{% endhint %}
{% endstep %}
{% step %}
#### Set filters
Navigate to the **Filter** tab to control the time range of the data shown.
* **Date range**: Select the period you want the widget to cover. The default is **Last 30 days**.
* **Advanced filters**: Use the **Add filter** option to refine the data further, for example, by a specific tag, sentiment, or source. You can also enable **Ignore global filter** if you want this widget to display independently of any dashboard-level filters.
{% hint style="info" %}
Unlike chart widgets, the Number widget does not have a time aggregation setting. The value displayed always represents the total or aggregate across the entire selected date range.
{% endhint %}
{% endstep %}
{% step %}
#### Save the widget
Once you are satisfied with the configuration, click **Save changes** to add the Number widget to your dashboard.
{% hint style="info" %}
Remember to save the Dashboard itself after setting up the widget, otherwise your changes will not be persisted.
{% endhint %}
{% endstep %}
{% endstepper %}
---
# 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://ask.birdie.ai/voice-of-customer/dashboards-and-reporting/dashboard-widgets/number-widget.md?ask=
```
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.