# echarts-gl

> Extension pack of ECharts providing 3D plots and globe visualization

Latest version **2.1.0** (published 2026-05-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install echarts-gl
pnpm add echarts-gl
yarn add echarts-gl
bun add echarts-gl
```

## Health

**Score 50/100 (C)** — status: active.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2026-05-28 |
| First published | 2017-04-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 6.7 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2716 |
| Maintainers | ecomfe-core, lang, errorrik, ovilia |

## Links

- npm: https://www.npmjs.com/package/echarts-gl
- Repository: https://github.com/ecomfe/echarts-gl
- Homepage: https://github.com/ecomfe/echarts-gl#readme
- Issues: https://github.com/ecomfe/echarts-gl/issues
- npm.io page: https://npm.io/package/echarts-gl

## Dependencies (2)

- [claygl](https://npm.io/package/claygl.md) ^1.2.1
- [zrender](https://npm.io/package/zrender.md) ^5.1.1 || ^6.0.0

## Recent versions

- 2.1.0 (latest) — 2026-05-28
- 2.0.0-rc.3 (rc) — 2020-12-22
- 2.0.9 — 2022-03-01
- 2.0.8 — 2021-08-06
- 2.0.7 — 2021-07-28
- 2.0.6 — 2021-07-03
- 2.0.5 — 2021-06-16
- 2.0.4 — 2021-04-08
- 2.0.3 — 2021-04-07
- 2.0.2 — 2021-02-17
- 2.0.1 — 2021-01-24
- 2.0.0 — 2021-01-16
- 1.1.2 — 2020-12-22
- 2.0.0-rc.2 — 2020-12-22
- 2.0.0-rc.1 — 2020-11-10
- … 20 more at https://npm.io/package/echarts-gl/versions

## README

# ECHARTS-GL

ECharts-GL is an extension pack of [Apache ECharts](http://echarts.apache.org/), which providing 3D plots, globe visualization and WebGL acceleration.


## Docs

+ [Option Manual](https://echarts.apache.org/zh/option-gl.html)

+ [Gallery](https://www.makeapie.com/explore.html#tags=echarts-gl)

## Installing

###  npm and webpack

```bash
npm install echarts
npm install echarts-gl
```

#### Import all
```js
import * as echarts from 'echarts';
import 'echarts-gl';
```

#### Minimal Import
```js
import * as echarts from 'echarts/core';
import { Scatter3DChart } from 'echarts-gl/charts';
import { Grid3DComponent } from 'echarts-gl/components';

echarts.use([Scatter3DChart, Grid3DComponent]);
```

### Include by scripts
```html
<script src="https://cdn.jsdelivr.net/npm/echarts/dist/echarts.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/echarts-gl/dist/echarts-gl.min.js"></script>
```

NOTE:

ECharts GL 2.x is compatible with ECharts 5.x.
ECharts GL 1.x is compatible with ECharts 4.x.

## Basic Usage

```js
var chart = echarts.init(document.getElementById('main'));
chart.setOption({
    grid3D: {},
    xAxis3D: {},
    yAxis3D: {},
    zAxis3D: {},
    series: [{
        type: 'scatter3D',
        symbolSize: 50,
        data: [[-1, -1, -1], [0, 0, 0], [1, 1, 1]],
        itemStyle: {
            opacity: 1
        }
    }]
})
```

## License

ECharts-GL is available under the BSD license.

## Notice

The Apache Software Foundation [Apache ECharts, ECharts](https://echarts.apache.org/), Apache, the Apache feather, and the Apache ECharts project logo are either registered trademarks or trademarks of the [Apache Software Foundation](https://www.apache.org/).

---
_Source: https://npm.io/package/echarts-gl · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._