apache /echarts

Apache ECharts is a free, powerful charting and visualization library offering easy ways to add intuitive, interactive, and highly customizable charts to your commercial products. It is written in pure JavaScript and based on zrender, which is a whole new lightweight canvas library.

中文官网 | ENGLISH HOMEPAGE

Get Apache ECharts

You may choose one of the following methods:

+ Download from the official website
+ npm install echarts --save
+ CDN: jsDelivr CDN

Docs

+ Get Started
+ API
+ Option Manual
+ Examples

Get Help

+ GitHub Issues for bug report and feature requests
+ Email [email protected] for general questions
+ Subscribe to the mailing list to get updated with the project

Build

Build echarts source code:

Execute the instructions in the root directory of the echarts:
(Node.js is required)

shell
Install the dependencies from NPM:
npm install

Rebuild source code immediately in watch mode when changing the source code.
It opens the ./test directory, and you may open -cases.html to get the list
of all test cases.
If you wish to create a test case, run npm run mktest:help to learn more.
npm run dev

Check the correctness of TypeScript code.
npm run checktype

If intending to build and get all types of the "production" files:
npm run release

Then the "production" files are generated in the dist directory.

Contribution

Please refer to the contributing document if you wish to debug locally or make pull requests.

Resources

Awesome ECharts

https://github.com/ecomfe/awesome-echarts

Extensions

+ ECharts GL An extension pack of ECharts, which provides 3D plots, globe visualization, and WebGL acceleration.

+ Liquidfill 水球图

+ Wordcloud 字符云

+ Extension for Baidu Map 百度地图扩展 An extension provides a wrapper of Baidu Map Service SDK.

+ vue-echarts ECharts component for Vue.js

+ echarts-stat Statistics tool for ECharts

License

ECharts is available under the Apache License V2.

Code of Conduct

Please refer to Apache Code of Conduct.

Paper

Deqing Li, Honghui Mei, Yi Shen, Shuang Su, Wenli Zhang, Junting Wang, Ming Zu, Wei Chen.
ECharts: A Declarative Framework for Rapid Construction of Web-based Visualization.
Visual Informatics, 2018.

Top issues

#6202Problems when updating chart through echartsInstance.setOption()65 comments · 2017-07-13 #11135[SURVEY] What companies are using Apache ECharts ?53 comments · 2019-08-30 #10079scroll event may prevent after use inside dataZoom45 comments · 2019-03-11 #15488Display the nearest data of different series in one tooltip.43 comments · 2021-08-06 #18255[Bug] [Violation] Added non-passive event listener to a scroll-blocking 'mousewheel' event. Consider marking event handler as 'passive' to make the page more responsive.39 comments · 2023-02-09 #15585[Feature] Show/hide Series33 comments · 2021-08-23 #11382echarts中实现多个tooltip存在28 comments · 2019-10-11 #20757OKLCH Color Support27 comments · 2025-02-13

Latest release

6.1.0 6.1.0 2026-05-19

+ [Feature] [axis] Support dataMin and dataMax option for calculating a nice axis extent. 20838 (Justin-ZS, 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 fe932a2aa 3973b21ee (100pah) 21511 (Akash Sonune)
+ [Feature] [axis] Automatically exclude non-positive series data values on "log" axis. dedc5dc18 (1

Snapshot: 2026-11-10T09:35:25Z · Data license Apache-2.0 · JSON