Number format

The numberFormat section controls how numeric values are displayed across the chart — axis ticks, tooltips, data labels and headlines. It sets the defaults; the renderer’s locale still governs locale-specific separators unless you override them here.

config({
  numberFormat: { decimals: 0, abbreviation: 'auto' },
});

Options

decimals

number | 'auto'

default:"auto"

Decimal places. A number fixes them (2 → 1234.56); 'auto' varies with magnitude.

abbreviation

'auto' | 'k' | 'm' | 'b' | 'none'

default:"auto"

How large numbers are shortened:

'none' — 1,234,567
'auto' — 1.2M, chosen by magnitude
'k' / 'm' / 'b' — force thousands / millions / billions

prefix

string

Text prepended to every value, e.g. '$'.

suffix

string

Text appended to every value, e.g. '%' or ' units'.

thousandsSeparator

string

Override the thousands separator. Defaults to the locale’s.

decimalSeparator

string

Override the decimal separator. Defaults to the locale’s.

Example

config({
  numberFormat: {
    decimals: 1,
    abbreviation: 'none',
    prefix: '$',
  },
});

Configuration overview
Quickstart › locale — the renderer’s formattingLocale

Get Started

Core concepts

Chart types

Annotations & emphasis

Rendering

Configuration

Advanced

Extending

Options

Example

​Options

​Example

​Related

Options

Example

Related