The number widget can be found at src/widgets/number/widget.jsx. Because the number widget is the most commonly used widget, the background colours are randomised to keep the dashboards unique. So don’t be surprised if you see them change colour.


  import NumberWidget from '../widgets/number/widget';
    title="Catz Conversion"


Prop Description Required
name Name of widget. Used to update the widget when a job completes Yes
title Title of widget. Usually displayed above the metric value Yes
metric Metric to use for value passed to widget e.g. % Optional
format How to format the widget value. See Numeral docs. Optional
size Size of the widget: small (default) or medium can be used Optional

Data Stucture

When building a job for a number widget, a single value should be used e.g.

data: { value: 1.4 };