# Number

To learn more about number charts and how to create one, please view this [video](https://youtu.be/WiZiIAKNG5U?si=RC9dIfHRSNaIqFel).

The Number chart displays a single aggregate measure with no dimensions.

| Features                                                                 | Quantity | Notes                   |
| ------------------------------------------------------------------------ | -------- | ----------------------- |
| Required [Measures](/v8.5.0/immerse/measures-and-dimensions.md#measures) | 1        | Maximum of one measure. |

Specify a measure and aggregation to create your Number chart.

{% hint style="info" %}
If you use custom SQL for your measure, it must use an aggregate function. To use a number chart to display a parameter value, use `avg(${`*`parameter_name`*`})`.
{% endhint %}

### Color Palette

Choose a color for your number that sets the correct tone. Red typically means danger or negative information, but it can also make the viewer more likely to agree with the value. Green is positive, but can be easier to overlook. Choosing the right color to match the information and message is both an art and a science.

### Custom Measure Formatting

You can also use custom measure formats for the value in your chart. See [Customizing Measure and Date Formats](/v8.5.0/immerse/measures-and-dimensions.md#customize-formats).

## Number Chart Examples

Choose a **Data Source**. This example uses the official database of [UFO sightings](https://github.com/planetsig/ufo-reports/tree/master/csv-data).

Choose an aggregate measure to display, and give the chart a title.

<figure><img src="/files/BpAKKVqCrn4ANzIvvtKF" alt=""><figcaption></figcaption></figure>

You can use a Number chart for dramatic impact, or to monitor a specific, important aggregate value from a dataset. You can use it to add emphasis to an important value in another chart on the dashboard.

<figure><img src="/files/KVV8sw6jEerbgA2MByFA" alt=""><figcaption></figcaption></figure>

You can use multiple Number charts on the same dashboard to show several aggregate values at once.

<figure><img src="/files/p2bXQdvEilv2QBrNNaIQ" alt=""><figcaption></figcaption></figure>


---

# 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://docs.heavy.ai/v8.5.0/immerse/immerse-chart-types/number.md?ask=<question>
```

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.