> ## Documentation Index
> Fetch the complete documentation index at: https://docs.graphy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/sdk-next/quickstart#4-theme-and-locale) still governs locale-specific separators unless you override them here.

```tsx theme={null}
config({
  numberFormat: { decimals: 0, abbreviation: 'auto' },
});
```

## Options

<ParamField path="decimals" type="number | 'auto'" default="auto">
  Decimal places. A number fixes them (`2` → `1234.56`); `'auto'` varies with
  magnitude.
</ParamField>

<ParamField path="abbreviation" type="'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
</ParamField>

<ParamField path="prefix" type="string">
  Text prepended to every value, e.g. `'$'`.
</ParamField>

<ParamField path="suffix" type="string">
  Text appended to every value, e.g. `'%'` or `' units'`.
</ParamField>

<ParamField path="thousandsSeparator" type="string">
  Override the thousands separator. Defaults to the locale's.
</ParamField>

<ParamField path="decimalSeparator" type="string">
  Override the decimal separator. Defaults to the locale's.
</ParamField>

## Example

```tsx theme={null}
config({
  numberFormat: {
    decimals: 1,
    abbreviation: 'none',
    prefix: '$',
  },
});
```

## Related

* [Configuration overview](/sdk-next/config/index)
* [Configuration overview › Locale](/sdk-next/config/index#locale) — `parsingLocale`, the fallback for display formatting
* [Quickstart › locale](/sdk-next/quickstart#4-theme-and-locale) — the renderer's `formattingLocale`