# Apache ECharts: what changed from 5 to 6

- Product: Apache ECharts (https://whatsnew.fyi/product/echarts)
- Vendor: Apache
- Range: changelog entries numbered after 5.6.0 up to and including 6.1.0, stable releases only
- Entries below: 2 releases (newest first)
- Resolved: 5 is 5.6.0 and 6 is 6.1.0, the newest stable release of each major we track
- Carrying security changes: 0 · CVEs mentioned: 0 · Mentioning breaking changes: 2 · Removing or deprecating something: 0
- Page: https://whatsnew.fyi/product/echarts/compare/5...6

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## What changed (44 changes, grouped by kind)

### Added

#### 6.1.0 (2026-05-19)

- Support `dataMin` and `dataMax` option for calculating a nice axis extent
- Enable all types of axis (`value`/`time`/`category`/`log`) to render series without overflow and provide `containShape` option and corresponding `clip` option
- Automatically exclude non-positive series data values on `log` axis
- Enable `axisLabel.formatter` to receive its index for working with `customValues`
- Add `triggerEvent` option for line series for more control over mouse event
- Add `tangential-noflip` rotation mode to pie labels to keep labels tangential without flipping
- Support `'auto'` value for `progress.color` in gauge charts
- Add `clockwise` option for radar charts
- Add `cursor` option for candlestick series and add `cursorGrab` and `cursorGrabbing` options for inside dataZoom
- Enable `clip` option on scatter and effectScatter series on geo
- Add `seriesTargets` option for visualMap to support multiple series-dimension mappings
- Support `matrix.x/y.length` for conveniently creating a headless matrix
- Add `triggerEvent` option to matrix series to support triggering event on matrix cells
- Add Latvian (LV) translation

#### 6.0.0 (2025-07-30)

- New theme for ECharts 6.0
- New chord series
- New matrix coordinate system with support for declaratively laying out all series and components in matrix and calendar coordinate system cells
- Support reusable custom series
- New layout mechanism for Cartesian grid component to prevent axis labels and axis names from overflowing the canvas and overlapping
- Support jittering for scatter series
- Support break on the axis
- Support dynamically registering and switching themes
- Roaming infrastructure enhancement including roamTrigger, clip support on geo and series.map, cursor style changes, preserveAspect option, and improved behavior for roaming area overlapping
- Support thumbnail for the graph series
- Support z option for markPoint/markLine/markArea
- Support z2 option for markPoint/markLine/markArea
- Support reversing the stack order
- Support roaming for sankey series
- Support compoundPath in custom series renderItem
- Support relativeTo option for specifying the relative target of marker position
- Support tooltip for angleAxis label
- Support displayTransition option to control whether to enable the tooltip display transition
- Support unboundedRange option for visualMap
- Support triggerEvent option for legend

### Fixed

#### 6.1.0 (2026-05-19)

- Change and clarify the rounding error and auto-precision utils and solutions
- Fix chart does not work when using `customValues` with `formatter` in time axis label
- Fix and clarify `alignTick` strategy and fix `LogScale` precision
- Fix duplicate ticks when using time axis or `customValues` which causes jitter of `splitArea` and fix `showMin/MaxLabel` handling of category axis
- Fix time axis bug when value scale is in millisecond
- Fix wrong label position when bar series has a 0 width/height
- Fix jitter layout does not support progressive rendering and cause chart to be frozen
- Fix effect symbol flip on unidirectional loop end when `roundTrip` is not enabled

#### 6.0.0 (2025-07-30)

- Fix label rich style does not inherit the plain label style
- Fix label layout margin

## Release notes

### 6.1.0

- Date: 2026-05-19
- Version: 6.1.0
- Original notes: https://github.com/apache/echarts/releases/tag/6.1.0
- Permalink: https://whatsnew.fyi/product/echarts/releases/6.1.0

- **added** — Support `dataMin` and `dataMax` option for calculating a nice axis extent
- **added** — Enable all types of axis (`value`/`time`/`category`/`log`) to render series without overflow and provide `containShape` option and corresponding `clip` option
- **added** — Automatically exclude non-positive series data values on `log` axis
- **added** — Enable `axisLabel.formatter` to receive its index for working with `customValues`
- **added** — Add `triggerEvent` option for line series for more control over mouse event
- **added** — Add `tangential-noflip` rotation mode to pie labels to keep labels tangential without flipping
- **added** — Support `'auto'` value for `progress.color` in gauge charts
- **added** — Add `clockwise` option for radar charts
- **added** — Add `cursor` option for candlestick series and add `cursorGrab` and `cursorGrabbing` options for inside dataZoom
- **added** — Enable `clip` option on scatter and effectScatter series on geo
- **added** — Add `seriesTargets` option for visualMap to support multiple series-dimension mappings
- **added** — Support `matrix.x/y.length` for conveniently creating a headless matrix
- **added** — Add `triggerEvent` option to matrix series to support triggering event on matrix cells
- **added** — Add Latvian (LV) translation
- **fixed** — Change and clarify the rounding error and auto-precision utils and solutions
- **fixed** — Fix chart does not work when using `customValues` with `formatter` in time axis label
- **fixed** — Fix and clarify `alignTick` strategy and fix `LogScale` precision
- **fixed** — Fix duplicate ticks when using time axis or `customValues` which causes jitter of `splitArea` and fix `showMin/MaxLabel` handling of category axis
- **fixed** — Fix time axis bug when value scale is in millisecond
- **fixed** — Fix wrong label position when bar series has a 0 width/height
- **fixed** — Fix jitter layout does not support progressive rendering and cause chart to be frozen
- **fixed** — Fix effect symbol flip on unidirectional loop end when `roundTrip` is not enabled

+ [Feature] [axis] Support `dataMin` and `dataMax` option for calculating a nice axis extent. [#20838](https://github.com/apache/echarts/pull/20838) ([Justin-ZS](https://github.com/Justin-ZS), [Ovilia](https://github.com/Ovilia))
+ [Feature] [axis] Comprehensively enable all types of axis (i.e., `"value"`/`"time"`/`"category"`/`"log"`) to render series (typically `"bar"`/`"pictorialBar"`/`"candlestick"`/`"boxplot"`) without overflow (including the case `"category"` axis with `boundaryGap: false`); provide `containShape` option; provide some corresponding `clip` option. [dbfaf6a73](https://github.com/apache/echarts/commit/dbfaf6a73) [fe932a2aa](https://github.com/apache/echarts/commit/fe932a2aa) [3973b21ee](https://github.com/apache/echarts/commit/3973b21ee) ([100pah](https://github.com/100pah)) [#21511](https://github.com/apache/echarts/pull/21511) ([Akash Sonune](https://github.com/akashsonune))
+ [Feature] [axis] Automatically exclude non-positive series data values on `"log"` axis. [dedc5dc18](https://github.com/apache/echarts/commit/dedc5dc18) ([100pah](https://github.com/100pah))
+ [Feature] [axis] Enable `axisLabel.formatter` to receive its index for working with `customValues`. [#21220](https://github.com/apache/echarts/pull/21220) [#21432](https://github.com/apache/echarts/pull/21432) ([Szymon Pachucki](https://github.com/szymonpachucki), [Ovilia](https://github.com/Ovilia), [plainheart](https://github.com/plainheart))
+ [Feature] [line] Add `triggerEvent` option for more control over mouse event. [#21001](https://github.com/apache/echarts/pull/21001) ([Steven Cobb](https://github.com/sjcobb), [plainheart](https://github.com/plainheart))
+ [Feature] [pie] Add `tangential-noflip` rotation mode to keep labels tangential without flipping. [#21258](https://github.com/apache/echarts/pull/21258) ([春秋半夏](https://github.com/MC-YCY), [Ovilia](https://github.com/Ovilia))
+ [Feature] [gauge] `progress.color` supports `'auto'`. [#21224](https://github.com/apache/echarts/pull/21224) ([StNimmerlein](https://github.com/StNimmerlein), [Ovilia](https://github.com/Ovilia))
+ [Feature] [radar] Add `clockwise` option. [#21143](https://github.com/apache/echarts/pull/21143) ([Dai Xuezhou](https://github.com/daidr), [Ovilia](https://github.com/Ovilia))
+ [Feature] [candlestick] [dataZoom] Add `cursor` option for `candlestick` series and add `cursorGrab` option & `cursorGrabbing` for `'inside'` dataZoom. [#21558](https://github.com/apache/echarts/pull/21558) ([zuming](https://github.com/diysimon), [Ovilia](https://github.com/Ovilia), [100pah](https://github.com/100pah))
+ [Feature] [scatter] [effectScatter] [geo] Enable `clip` option on `"scatter"`/`"effectScatter"` on `geo`. [417592289](https://github.com/apache/echarts/commit/417592289) ([100pah](https://github.com/100pah))
+ [Feature] [visualMap] Add `seriesTargets` option for multiple series-dimension mappings. [#20703](https://github.com/apache/echarts/pull/20703) ([Justin-ZS](https://github.com/Justin-ZS), [plainheart](https://github.com/plainheart))
+ [Feature] [matrix] Support `matrix.x/y.length` for conveniently creating a headless matrix without composing an array. [#21191](https://github.com/apache/echarts/pull/21191) ([100pah](https://github.com/100pah), [plainheart](https://github.com/plainheart))
+ [Feature] [matrix] Add `triggerEvent` option to support triggering event on matrix cells. [#21390](https://github.com/apache/echarts/pull/21390) ([Natsuo Kawai](https://github.com/natsuokawai), [100pah](https://github.com/100pah))
+ [Feature] [i18n] add Latvian(LV) translation. [#21546](https://github.com/apache/echarts/pull/21546) ([EPoikans](https://github.com/EPoikans))
+ [Fix] [axis] Change and clarify the rounding error and auto-precision utils and solutions. [479dcd454](https://github.com/apache/echarts/commit/479dcd454) ([100pah](https://github.com/100pah))
+ [Fix] [axis] Fix chart does not work when using `customValues` with `formatter` in time axis (`axis.type:

_[Truncated at 4000 characters — full notes: https://github.com/apache/echarts/releases/tag/6.1.0]_

### 6.0.0

- Date: 2025-07-30
- Version: 6.0.0
- Original notes: https://github.com/apache/echarts/releases/tag/6.0.0
- Permalink: https://whatsnew.fyi/product/echarts/releases/6.0.0

- **added** — New theme for ECharts 6.0
- **added** — New chord series
- **added** — New matrix coordinate system with support for declaratively laying out all series and components in matrix and calendar coordinate system cells
- **added** — Support reusable custom series
- **added** — New layout mechanism for Cartesian grid component to prevent axis labels and axis names from overflowing the canvas and overlapping
- **added** — Support jittering for scatter series
- **added** — Support break on the axis
- **added** — Support dynamically registering and switching themes
- **added** — Roaming infrastructure enhancement including roamTrigger, clip support on geo and series.map, cursor style changes, preserveAspect option, and improved behavior for roaming area overlapping
- **added** — Support thumbnail for the graph series
- **added** — Support z option for markPoint/markLine/markArea
- **added** — Support z2 option for markPoint/markLine/markArea
- **added** — Support reversing the stack order
- **added** — Support roaming for sankey series
- **added** — Support compoundPath in custom series renderItem
- **added** — Support relativeTo option for specifying the relative target of marker position
- **added** — Support tooltip for angleAxis label
- **added** — Support displayTransition option to control whether to enable the tooltip display transition
- **added** — Support unboundedRange option for visualMap
- **added** — Support triggerEvent option for legend
- **fixed** — Fix label rich style does not inherit the plain label style
- **fixed** — Fix label layout margin

+ [Feature] [theme] New theme for ECharts 6.0. [#20865](https://github.com/apache/echarts/issues/20865) [#21097](https://github.com/apache/echarts/issues/21097) [#21114](https://github.com/apache/echarts/issues/21114) ([Ovilia](https://github.com/Ovilia))
+ [Feature] [chord] New chord series. [#20522](https://github.com/apache/echarts/issues/20522) ([Ovilia](https://github.com/Ovilia))
+ [Feature] [matrix&calendar] New matrix coordinate system. And all series and components (including other coordinate systems, such as `grid`(Cartesian), `geo`, `polar`, etc.) are supported to be declaratively laid out in the cells of matrix and calendar coordinate system. [#19807](https://github.com/apache/echarts/issues/19807) [#21093](https://github.com/apache/echarts/pull/21093) ([Ovilia](https://github.com/Ovilia)) [#21005](https://github.com/apache/echarts/issues/21005) [#21108](https://github.com/apache/echarts/issues/21108) ([100pah](https://github.com/100pah))
+ [Feature] [custom] Support reusable custom series. [#20226](https://github.com/apache/echarts/issues/20226) ([Ovilia](https://github.com/Ovilia))
+ [Feature] [cartesian] Introduce new layout mechanism to avoid Cartesian (i.e., `grid` component) axis labels and axis names overflowing the canvas, prevent axis names from overlapping with axis labels, and make them the default. [#21059](https://github.com/apache/echarts/pull/21059) ([100pah](https://github.com/100pah)) [#19534](https://github.com/apache/echarts/pull/19534) ([robin-gerling](https://github.com/robin-gerling)) [#16825](https://github.com/apache/echarts/pull/16825) ([konrad-amtenbrink](https://github.com/konrad-amtenbrink))
+ [Feature] [scatter] Support jittering for scatter series. [#19941](https://github.com/apache/echarts/issues/19941) [#21067](https://github.com/apache/echarts/pull/21067) ([Ovilia](https://github.com/Ovilia))
+ [Feature] [axis] Support break on the axis. [#19459](https://github.com/apache/echarts/issues/19459) ([Ovilia](https://github.com/Ovilia)) [#20857](https://github.com/apache/echarts/issues/20857) ([100pah](https://github.com/100pah))
+ [Feature] [theme] Support dynamically registering and switching themes. [#20705](https://github.com/apache/echarts/issues/20705) ([Ovilia](https://github.com/Ovilia))
+ [Feature] [roam] Roaming infrastructure enhancement - support users specifying roaming area by `roamTrigger`; support `clip` on `geo` and `series.map`; support cursor style change when hovering on the roaming area; support `preserveAspect` on `geo`, `series.map` and `series.graph`; fix the percent base of `center` on `geo`, `series.map`, `series.graph` and `series.tree`; enhance the behavior for roaming area overlapping. [#19807#issuecomment-2974437299](https://github.com/apache/echarts/pull/19807#issuecomment-2974437299) ([100pah](https://github.com/100pah))
+ [Feature] [thumbnail] Support thumbnail for the graph series. [#19807#issuecomment-3013454598](https://github.com/apache/echarts/pull/19807#issuecomment-3013454598) ([100pah](https://github.com/100pah)) [#17471](https://github.com/apache/echarts/issues/17471) ([Lruler](https://github.com/Lruler))
+ [Feature] [marker] Support `z` option for markPoint/markLine/markArea. [#21117](https://github.com/apache/echarts/issues/21117) ([sz-p](https://github.com/sz-p))
+ [Feature] [marker] Support `z2` option for markPoint/markLine/markArea. [#20782](https://github.com/apache/echarts/issues/20782) ([sz-p](https://github.com/sz-p))
+ [Feature] [stack] Support reversing the stack order. [#20998](https://github.com/apache/echarts/issues/20998) ([Justin-ZS](https://github.com/Justin-ZS))
+ [Feature] [sankey] Support roaming for sankey series. [#20321](https://github.com/apache/echarts/issues/20321) ([Ovilia](https://github.com/Ovilia))
+ [Feature] [custom] Support compoundPath in custom series renderItem. [#20402](https://github.com/apache/echarts/issues/20402) [#21040](https://github.com/apache/echarts/issues/21040) ([Ovilia](https://githu

_[Truncated at 4000 characters — full notes: https://github.com/apache/echarts/releases/tag/6.0.0]_