Previous versions

Version 2 has a completely different API than earlier versions.

Most earlier version options have current equivalents or are the same.

Please use the documentation that is available on for the current version of Chart.js.

Please note - documentation for previous versions are available on the GitHub repo.

Browser support

Chart.js offers support for all browsers where canvas is supported.

Browser support for the canvas element is available in all modern & major mobile browsers (

Thanks to BrowserStack for allowing our team to test on thousands of browsers.

Bugs & issues

Please report these on the GitHub page - at If you could include a link to a simple jsbin or similar to demonstrate the issue, that’d be really helpful.


New contributions to the library are welcome, but we ask that you please follow these guidelines:


Chart.js is open source and available under the MIT license.

Charting Library Comparison

Library Features

Feature Chart.js D3 HighCharts Chartist
Completely Free ✓ ✓   ✓
Canvas ✓      
SVG   ✓ ✓ ✓
Built-in Charts ✓   ✓ ✓
8+ Chart Types ✓ ✓ ✓  
Extendable to Custom Charts ✓ ✓    
Supports Modern Browsers ✓ ✓ ✓ ✓
Extensive Documentation ✓ ✓ ✓ ✓
Open Source ✓ ✓ ✓ ✓

Built in Chart Types

Type Chart.js HighCharts Chartist
Combined Types ✓ ✓  
Line ✓ ✓ ✓
Bar ✓ ✓ ✓
Horizontal Bar ✓ ✓ ✓
Pie/Doughnut ✓ ✓ ✓
Polar Area ✓ ✓  
Radar ✓    
Scatter ✓ ✓ ✓
Bubble ✓    
Gauges   ✓  
Maps (Heat/Tree/etc.)   ✓  

There are many plugins that add additional functionality to Chart.js. Some particularly notable ones are listed here. In addition, many plugins can be found on the Chart.js GitHub organization.

There are many extensions which are available for use with popular frameworks. Some particularly notable ones are listed here.




Ruby on Rails