---
title: "Upgrade to AG Charts 12.0"
framework: react
version: "14.1.0"
---

# Upgrade to AG Charts 12.0

## What's New

See the [release post](https://blog.ag-grid.com/whats-new-in-ag-charts-12/) for feature highlights of what's new in this major version.

Users of integrated charting on AG Grid, should refer to this migration guide when upgrading to AG Grid version 36.1.

## Documentation

[See AG Charts 12.0 Documentation](https://www.ag-grid.com/charts/archive/12.0.2/documentation)

## Breaking Changes

The full list of breaking changes across all features for version 12.0.

**Breaking Changes:**

This release includes the following breaking changes:

### Series Changes

- `series[].type` is now required.

### Axes Changes

- `time` axis properties of `unit`, `paddingInner`, `paddingOuter`, `groupPaddingInner` are removed. Use the `unit-time` axis instead.

### Miscellaneous

- `theme.params.padding` - removed, use `chartPadding` instead.
- All Series `series[].listeners[]`:
  - `.nodeClick` - removed, use `.seriesNodeClick` instead.
  - `.nodeDoubleClick` - removed, use `.seriesNodeDoubleClick` instead.

## Behaviour Changes

The full list of behaviour changes across all features for version 12.0.

**Behaviour Changes:**

This release includes the following behaviour changes:

### Series

- When Bubble Series `labelKey` is not provided, the `sizeKey` is used for the label text instead of the `yKey`.
- Series with a `labelKey` defined will show the label value in the tooltip.

### Axes

- Vertical `time` and `ordinal-time` axes are now sorted with the earliest date at the top. Use `reverse` to change this.
- Default label formats for `time` and `ordinal-time` axes have been improved.
- Axis `thickness` defaults to a maximum of 30% of the chart size.

### Theme Defaults

- If the `stroke` property is provided, a default `strokeWidth` will be used to display a stroke.
- When the Mini Chart is enabled, the Navigator default height is 40px.
- The following `theme.params` defaults have changed which will result in very slight colour changes.
  - `foregroundColor` is changed from `#464646` to `#181d1f`.
  - `axisColor` is changed from `#c3c3c3` to `#b4b6b6`.
  - `borderColor` is changed from `#dddddd` to `rgba(24, 29, 31, 0.15)`.
  - `chromeBackgroundColor` is changed from `#fafafa` to `#fafafb`.
  - `crosshairLabelBackgroundColor` is changed from `#464646` to `#181d1f`.
  - `foregroundColor` is changed from `#464646` to `#181d1f`.
  - `gridLineColor` is changed from `#e0eaf2` to `#e8e8e9`.
  - `inputTextColor` is changed from `#464646` to `#181d1f`.
  - `subtleTextColor` is changed from `#8c8c8c` to `#707374`.
  - `textColor` is changed from `#464646` to `#181d1f`.
- New `popupShadow` and `focusShadow` are added to `theme.params` and will appear around popup dialogues.

### Other Changes

- `zoom.autoScaling` defaults to `true`. Use `enabled: false` to disable.
- "Reset Zoom" is added to the default Context Menu items. Provide explicit `contextMenu.items` change this.

## Deprecations

**Deprecations:**

This release includes the following deprecations:

- `time` import is deprecated. Use an `AgTimeInterval` string directly, or an `AgTimeIntervalUnit` object instead.
- `AgTimeInterval` of `utcYear`, `utcMonth`, `utcDay`, `utcHour` are removed, use an `AgTimeIntervalUnit` object with `utc: true` instead.
- `AgTimeInterval` of `week` is removed. Use an `AgTimeIntervalUnit` object with `{ unit: 'day', 'step: 7' }` and a format of `%a` or `%A` instead.
- `highlightStyle` is removed from all series except `treemap` and `sunburst`. Use `highlight` options instead.

## Removal of Deprecated Properties

The following properties have been deprecated since version 11 and have now been removed.

**Removed Deprecated Properties:**

- `zoom.minVisibleItemsX` and `zoom.minVisibleItemsY` - removed. Use `zoom.minVisibleItems` instead.
- `tooltip.position.type` in both chart and series options - removed. Use `tooltip.position.anchorTo` and/or `tooltip.position.placement` instead.
- `minVisibleItemsX` and `minVisibleItemsY` have been removed in favour of `minVisibleItems`
- `contextMenu.extraActions[]`, `contextMenu.extraSeriesAreaActions[]`, `contextMenu.extraNodeActions`, and `contextMenu.extraLegendItemActions` - removed. Use `contextMenu.items[]` with the appropriate showOn value instead.

## Changes List

[See the full changelog for v12.0.0](https://www.ag-grid.com/charts/changelog/?fixVersion=12.0.0)