---
title: "Upgrade to AG Charts 9"
framework: javascript
version: "14.1.0"
---

# Upgrade to AG Charts 9

## AG Charts 9

### What's New

See the [release post](https://blog.ag-grid.com/whats-new-in-ag-charts-9/) 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 31.

### Breaking Changes

This release includes the following breaking changes:

**Series Changes**

- `sizeKey` is removed from `scatter` series. Use `bubble` series instead.
- `treemap` series has been removed. Use the new Enterprise treemap series instead.
- `column` series has been removed. Use `bar` series.
- `bar` series now gives a vertical representation by default. Use `series[].direction = 'horizontal'` for a horizontal representation.

**Note:** The `bar` and `column` changes do NOT affect any AG Grid APIs used for integrated charts. They do, however, affect theme overrides.

**Padding**

- `seriesAreaPadding` has moved to `seriesArea.padding`.
- `axes[].groupPaddingInner` now only adds padding between grouped items. To add padding between groups, use `groupPaddingOuter`.

**Axes**

- `axes[].gridStyle` option moved to `axes[].gridLine.style`.
- `axes[].tick.count` - removed.

**Themes**

- `ag-pastel`, `ag-pastel-dark`, `ag-solar`, `ag-solar-dark` themes are removed.
- The root `type` field is removed from themes.
- `theme.overrides.{cartesian,polar,hierarchy}` options are removed.

**Miscellaneous**

- `tooltip.tracking` - removed.
- The following are removed from `AgPieSeriesLabelFormatterParams`. These values can be obtained from the `datum` object in conjunction with `angleKey`.
  - `calloutLabelValue`
  - `sectorLabelValue`
  - `angleValue`
  - `radiusValue`.
- `AgCartesianChartOptions`
  - `type` property is removed.
- `AgHierarchyChartOptions`
  - `type` property is removed.
- `AgPolarChartOptions`
  - `type` property is removed.

### Behaviour Changes

This release includes the following default behaviour changes:

**Themes Defaults**

- Themes have new default values for `fills` and `strokes`.
- Axis line is hidden by default for Number Axes. Use `axes[].line.enabled` to show.
- Axis ticks are not shown by default. Use `axes[].tick.enabled` to show.

**Other Changes**

- The Pie Series remains centred within the container regardless of callout label size. Only the radius size changes when avoiding callout label collisions.
- `axes[].tick` styles are no longer inherited by grid lines. Use `axes[].gridLine.style`.

### Deprecations

This release includes the following deprecations:

- `agCharts.AgChart` - deprecated. Use `agCharts.AgCharts`.

### Changes List

If you would like to see the full list of changes in this release, please see the [Changelog](https://www.ag-grid.com/charts/changelog/?fixVersion=9.0.0).

## Minor Versions

### AG Charts 9.3

- Read the [What's New](https://blog.ag-grid.com/whats-new-in-ag-charts-9-3/) blog post.
- See the [Upgrade notes](https://www.ag-grid.com/charts/javascript/upgrade-to-ag-charts-9-3/).
- See the [Changelog](https://www.ag-grid.com/charts/changelog/?fixVersion=9.3.0).

### AG Charts 9.2

- Read the [What's New](https://blog.ag-grid.com/whats-new-in-ag-charts-9-2/) blog post.
- See the [Upgrade notes](https://www.ag-grid.com/charts/javascript/upgrade-to-ag-charts-9-2/).
- See the [Changelog](https://www.ag-grid.com/charts/changelog/?fixVersion=9.2.0).

### AG Charts 9.1

- Read the [What's New](https://blog.ag-grid.com/whats-new-in-ag-charts-9-1/) blog post.
- See the [Upgrade notes](https://www.ag-grid.com/charts/javascript/upgrade-to-ag-charts-9-1/).
- See the [Changelog](https://www.ag-grid.com/charts/changelog/?fixVersion=9.1.0).