Guide to using the number visualization

A number is an arithmetical value, expressed by a word, symbol, or figure, representing a particular quantity. It is used in counting and making calculations.

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.

Number_widget.png

 

In this article:

 

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.

Back to top

 

Example uses

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.

 First_response_time.png

 

Back to top

Anatomy of the number

Number_anatomy.png

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).

Back to top

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 $.

 

Fine_tune.gif

 

 

Back to top

API and integrations

API

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.

Integrations

The number visualization is available for most pre-built integrations. Notably, for the Spreadsheets and Salesforce ones.

Back to top

 

FAQs

 
Why is the secondary stat showing an infinite (∞) variation?
 
Number widgets in some integrations could show an infinite percentual change when there's a change from 0 to anything different than 0. If you ever see an infinite percentual change, it will mean that your previous record was a zero. 
 
That said, this is something that newer integrations handle differently. Newer number widgets will display the absolute difference in this scenario. 

Back to top

 

Was this article helpful?
👍

Thank you for your feedback!