The number visualization is focused on the display of a metric that can be represented by a single number, along with optional associated secondary metrics, such as a change or trend indication.
In this article:
- When to use a number
- Example uses
- Anatomy of the number
- Tips for creating numbers
- API and integrations
When to use a number
Use this visualization when the number is the most important aspect of the metric you're trying to display, such as today's sales, or yesterday's website unique visitors.
The secondary statistic can then be used to give context to the current value.
The number is very versatile and has a variety of configurations. We recommend using it for KPIs and metrics where the numerical value is of the utmost importance. For example a key metric among customer support teams is first response time. A number associated to it is immediately understandable, hence a number is ideal.
Anatomy of the number
The number consists of a principal metric (which can use a prefix such as a currency symbol or a suffix such as a percentage symbol) with an optional label as well as a secondary metric that can be compared through a visual indicator of a red down arrow or green up arrow. The second metric can be either absolute, or compared to the principal metric as a percentage.
This visualization can also have an array of numbers displayed as a trendline below (as the secondary stat).
Tips for creating numbers
Decide on a clear title. The title should be a brief description of the data that you want to show.
Add a secondary statistic to give context to the numerical value. For example if your metric is "MRR added in the last 7 days", having a reference of how much MRR was added on the previous 7 days can serve as a barometer of how good or bad the number is.
Use the Decimal Places feature to manually set the precision of numbers in your widgets, so that you can show the level of detail appropriate for your dashboard.
If needed, you can also override our automatic settings for what abbreviation and unit to show.
Abbreviation, Decimal Places and Unit are part of the "Fine-tune" settings.
Abbreviation: Numbers can be shown in their raw state, or as Thousands (K), Millions (M), or Billions (B).
Unit: Allows you to manually enter any prefix or suffix up to 3 characters long. This means if you’d prefer to display your currency differently to our default option you now can. As examples you might want Swedish Krona to show as 100 Kr instead of SEK 100, or New Zealand Dollars to just have the $.
API and integrations
You can build numbers using the API (custom widgets).
For detailed information on how to display a number using custom widgets, please visit our Developer Documentation.