---
url: https://chartbuddy.io/embed/docs/configuration/labels.md
---
> Docs index: [llms.txt](https://chartbuddy.io/embed/docs/llms.txt)

# Labels

Three different things look like "the numbers on the chart." They are not the same key.

| What you mean | What it is | Key |
|---|---|---|
| Legend / series names | Legend chrome | `legend.visible` / `seriesLabels` |
| Numbers on each segment | Data labels (off unless you turn them on) | `annotations.dataLabels` |
| Numbers on the bar / stack | Totals (on by default) | `annotations.totals.visible` |

***

## Hide the numbers on the bars

```js
{
  chartType: 'clusteredBar',
  isDataTransposed: true,
  seriesData: [/* … */],
  annotations: { totals: { visible: false } },
}
```

That is the control. Totals default **on** for clustered bar, stacked bar, mekko, bar mekko, and waterfall.

***

## Do not invent these

These keys do not hide totals. `validateChartData` accepts them (`valid: true`) and emits an `unknown-key` warning with `suggestion: "annotations.totals.visible"`:

* `annotations.showTotalLabels`
* `annotations.showTotals` / `showTotal`
* `annotations.dataLabels.showTotal`
* top-level `showTotalLabels` or `dataLabels`

`seriesLabels` is series-name chrome, not bar totals.

***

## Data labels vs totals

`annotations.dataLabels` paints a number **inside** each segment. It is a per-series visibility array (or a boolean). Leave it alone unless you want in-bar labels.

`annotations.totals` paints one number **on top of** the category (clustered) or the stack (stacked / mekko / waterfall).

Format those numbers with `annotations.totals.numberFormat` and `annotations.dataLabels.numberFormat`. See [Number formats](https://chartbuddy.io/embed/docs/configuration/number-formats.md).

***

## Related

* [chartData schema](https://chartbuddy.io/embed/docs/api/chart-data.md)
* [Clustered bar](https://chartbuddy.io/embed/docs/chart-types/clustered-bar.md)
* [Stacked bar](https://chartbuddy.io/embed/docs/chart-types/stacked-bar.md)
* [Validation](https://chartbuddy.io/embed/docs/quality-assurance/validation.md)