NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #5111 most downloaded on Packagist
Simple HTML5 charts using the canvas element.
Latest stable
v4.6.1
Last release 26 days ago
22 Oct 2026
Release timing varies
gaps range from 2 weeks to 12 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
107 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Thanks to @LeeLenaleee, @benmccann, @etimberg, @kashifshamaz21 and @kurkle
Thanks to @LeeLenaleee, @benmccann, @etimberg, @kashifshamaz21 and @kurkle
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Thanks to @LeeLenaleee, @benmccann, @etimberg, @kurkle and @stockiNail
Thanks to @LeeLenaleee, @benmccann, @etimberg, @kurkle and @stockiNail
Thanks to @LeeLenaleee, @dependabot, @dependabot[bot], @etimberg, @iamarcel, @joshkel and @kurkle
Thanks to @LeeLenaleee, @dependabot, @dependabot[bot], @etimberg, @iamarcel, @joshkel and @kurkle
Thanks to @LeeLenaleee, @benmccann, @etimberg and @kurkle
Thanks to @LeeLenaleee, @benmccann, @etimberg and @kurkle
Thanks to @LeeLenaleee, @UrielMaD, @benmccann, @dcyou, @etimberg, @joshkel, @kurkle, @salmankazmi and @stockiNail
Thanks to @LeeLenaleee, @UrielMaD, @benmccann, @dcyou, @etimberg, @joshkel, @kurkle, @salmankazmi and @stockiNail
Thanks to @IVIosi, @LeeLenaleee, @dependabot, @dependabot[bot], @etimberg, @kurkle, @lab900-marcel-samyn, @lpellegr, @saintmalik, @wenfangdu and @xr0m
Thanks to @IVIosi, @LeeLenaleee, @dependabot, @dependabot[bot], @etimberg, @kurkle, @lab900-marcel-samyn, @lpellegr, @saintmalik, @wenfangdu and @xr0master
Thanks to @emmcbd, @etimberg, @kurkle and @xr0master
Thanks to @emmcbd, @etimberg, @kurkle and @xr0master
Thanks to @danmana, @etimberg, @fab313, @indigolain, @kurkle, @paul-cheung, @silentmatt, @stockiNail and @Yash-Singh1
getElementsAtEventForMode and remove APIs that can be replaced by itmerge target, to prevent prototype pollutiongetElementsAtEventForMode and remove APIs that can be replaced by itThanks to @danmana, @etimberg, @fab313, @indigolain, @kurkle, @paul-cheung, @silentmatt, @stockiNail and @Yash-Singh1
Thanks to @emmcbd, @etimberg, @kurkle, @mikos and @tonyjmartinez
elements.arc.angle option now returns degreesskipNull to bar charts that enables skipping null valuesThanks to @emmcbd, @etimberg, @kurkle, @mikos and @tonyjmartinez
# Essential Links * npm * Migration guide * Docs * API * Samples # Bugs Fixed * #7829 ESM chunks files were not include in the NPM distribution * #782
The main highlight of this 2nd beta release is improvements to the 1st party Typescript types. Feedback on these types is greatly appreciated.
The main highlight of this 2nd beta release is improvements to the 1st party Typescript types. Feedback on these types is greatly appreciated.
The helpers are now exposed in a flat format for both UMD & ESM cases. See #7750 for details.
isoWeekday time options on time scale as number. Thanks @stockiNailIntl.NumberFormat instancesIChartDataChart.register instead of Chart.plugins.registerThe main highlight of this first 3.0.0 beta release is the introduction of 1st party Typescript types. Feedback on these types is appreciated.
The main highlight of this first 3.0.0 beta release is the introduction of 1st party Typescript types. Feedback on these types is appreciated.
getLabelAndValueChart.defaults alwaysThere are many breaking changes in this release of Chart.js in addition to those introduce in the previous 3.0.0-alpha release. Most will not be notic…
The main highlight of this second 3.0.0 alpha release is the introduction of tree shaking. When using a bundler, such as Rollup or Webpack, the bundler can now remove unused charts, scales, and plugins from your code to result in a smaller bundle being delivered to the end user.
There are many breaking changes in this release of Chart.js in addition to those introduce in the previous 3.0.0-alpha release. Most will not be noticeable to users as they are in the internals of the chart, or at points where plugins & scales interface with the chart. However, there are changes to the config option format in v3 that will affect all users of Chart.js. Most noticeably, in all alpha releases, scales are no longer specified in an array and instead are specified in an object. The migration guide provides more details on all of the changes made so far.
Major breaking changes since the last alpha release include:
Chart.js to chart.jsnpm users must register the charts, scales, elements, and plugins they wish to use (#7435)time and timeseries scales (#7525)'nearest' to match vertical bar charts. #7488indexAxis concept. #7514value renamed to formattedValue. (#7618)aspectRatio to 1 for square chartsonClick callback supports arrow functions@rollup/plugin-inject for ResizeObserver polyscale.init methodisoWeekday when roundingfilterBetween_dataCheckbr tags self-closinginnerRadius/outerRadiuslayout.defaultsgetPixelForTick cleanupResizeObserver for UMD buildsThere are many breaking changes in this release of Chart.js. Most will not be noticeable to users as they are in the internals of the chart, or at poi…
There are many breaking changes in this release of Chart.js. Most will not be noticeable to users as they are in the internals of the chart, or at points where plugins & scales interface with the chart. However, there are changes to the config option format in v3. Most noticeably, scales are no longer specified in an array and instead are specified in an object. The migration guide provides more details on all of the changes made so far.
onUpdate()Numerous performance enhancements have been added including the ones below. This may result in 10x or more faster performance in some use cases. Chart.js is now more than 3x faster on the uPlot benchmark.
arrayUniqueupdateElement to updateElementsfor of loops to regular ones for IE11 compatibilitygridLines.display is false, the axis border is still drawnorderThis is the last release of v2 and focused on fixing bugs identified in the v2.9.3 release.
This is the last release of v2 and focused on fixing bugs identified in the v2.9.3 release.
merge target, to prevent prototype pollutionThanks to the maintainers and collaborators for their help to improve and test Chart.js (@kurkle, @benmccann, and @etimberg).
Thanks to the maintainers and collaborators for their help to improve and test Chart.js (@kurkle, @benmccann, and @etimberg).
Thanks to the maintainers and collaborators for their help to improve and test Chart.js (@nagix, @kurkle, @benmccann, @etimberg and @simonbrunel).
Thanks to the maintainers and collaborators for their help to improve and test Chart.js (@nagix, @kurkle, @benmccann, @etimberg and @simonbrunel).
Thanks to the maintainers and collaborators for their help to improve and test Chart.js (@nagix, @kurkle, @benmccann, @etimberg and @simonbrunel).
scale.getDecimalForPixel to the chart areaThanks to the maintainers and collaborators for their help to improve and test Chart.js (@nagix, @kurkle, @benmccann, @etimberg and @simonbrunel).
https://github.com/chartjs/Chart.js/pull/6246 Avoid time related deprecation warnings in tests
helpers._decimalPlaces is now privatedataset.orderautoSkip aware of major ticksoffsetGridLines is truespanGaps in radar chartspointStyle image[start, end])min and max in standard mannerhelpers.eachticks.sampleSize optionticks.source:'labels'helpers.each with for-loopscore.layoutgetScaleForId() calls in the line controllerhelpers.extendautoSkip is enabledzeroLineIndex is definedtoExponential between 0 and 20. Thanks @veggiesaurusgetValueForPixel in time scalelineTensiontick.major in tickFormatFunctiondetermineUnitForFormatting floating point errorticks.minor and ticks.major issueshelpers.almostWholeelements.arc.angle in documentationticks.display and add pointLabels.displaycubicInterpolationMode and fill. Thanks @stockiNailautoSkip in updatehelpers.math._factorizeThanks to the maintainers and collaborators for their help to improve and test Chart.js (@nagix, @kurkle, @benmccann, @etimberg and @simonbrunel).
Documentation: http://www.chartjs.org/docs/2.8.0/
Documentation: http://www.chartjs.org/docs/2.8.0/
Chart.{Type} classesconfigMerge and scaleMerge helpersminBarLength option for bar chart. Thanks @adubereverse support to time scaleonLeave callback to legend. Thanks @jonrimmeroffsetGridLine behavior with a single data pointdata.labelslineWidth as an arraynew Number() is correctly handledstepSizeinnerHTML usage from our DOM platformafterBuildTicksscale.pointLabels.lineHeight and scale.ticks.lineHeight optionsautoSkip is trueticks.reverse issuegetRightValue to number in bar chartfitWithPointLabels calculation in radial linear scalexLabel and yLabel with label and valueusePointStyle is true. Thanks @alfiehdinsertElementsgetArea implementation for horizontal barsaddEventListener and removeEventListenerdataset.data arraysaspectRatio property. Thanks @danielcb29parser instead of the deprecated format option. Thanks @Niladri24duttapadding option. Thanks @JEphronchartjs-plugin-colorschemesbarThickness. Thanks @jedrekdomanskiomi-chart to the doc. Thanks @dntzhangChart.min.js in samplesmaintainAspectRatio. Thanks @janelledementpointBackgroundColor in radar samplechartjs-plugin-crosshair. Thanks @AbelHeinsbroekchartjs-plugin-rough*.js test fixture configs.editorconfig file to include newlines at EOF. Thanks @jtagschererChart.controllers.* importablegulp-connect and add jsdelivr/unpkg pathshelpers.options.resolveremoveResizeListener. Thanks @DanielRufThanks to the maintainers and collaborators for their help to improve and test Chart.js (@nagix, @kurkle, @benmccann, @etimberg and @simonbrunel).
More details in the release PR: #6092
Nothing published for this version
Documentation: http://www.chartjs.org/docs/2.7.3/
Documentation: http://www.chartjs.org/docs/2.7.3/
ticks.precision option to linear scaleresponsive: true and Chart is hidden. Thanks @jcopperfieldChart.Animation/animations/Tooltip importableChart.Scale/scaleService importableMore details in the release PR: #5732
Documentation: http://www.chartjs.org/docs/2.7.2/
Documentation: http://www.chartjs.org/docs/2.7.2/
point.xRange and point.yRange performance. Thanks @fanthostime.unit option to create default min/max for empty chart. Thanks @jcopperfieldChart.Ticks.formatterslegendCallback. Thanks @cameroncfChart.layout(Service) importableChart.plugins importableChart.layout to Chart.layoutspackage-lock.jsonshowLines in scatter chart. Thanks @loicbourgoisMore details in the release PR: #5145
2.7.1 is a bug fix release and also includes numerous documentation improvements
2.7.1 is a bug fix release and also includes numerous documentation improvements
Documentation: http://www.chartjs.org/docs/2.7.1/
beforeTooltipDraw and afterTooltipDraw to plugins. Thanks @JewelsJLFnull style. Thanks @Rydoriextend and inherits helpersMore details in the release PR: #4876
Version 2.7 brings better stability, and powerful new features to Chart.js. The bubble chart options are now completely scriptable. This means that yo
Version 2.7 brings better stability, and powerful new features to Chart.js. The bubble chart options are now completely scriptable. This means that you can pass a function to a bubble chart dataset property and have the function be called as needed. This simplifies array properties, and allows quick and easy rendering changes based on data values. Check out the sample for details. If these options prove useful, they can be extended to other chart types in the future.
Building off the time scale rewrite in version 2.6, the time scale now supports options for configuring how labels generate ticks, how interpolation between the points is handled and the scale boundary strategy. Users can now configure ticks to be generated for each label, or be determined automatically from the data limits. Users can also change how ticks are distributed along the axis] to make non-linear time axes. Check out the sample for details.
Documentation: http://www.chartjs.org/docs/2.7.0/
2 to be consistent with other charts and are not square anymore by default. Use the aspectRatio: 1 option to restore the previous behaviour.unitStepSize, use stepSize instead.labelTextColor callback. Thanks @apoorvasrinivasanmajor unit options. Thanks @hurskiy-andriydevicePixelRatio option. Thanks @OlduwanSteveaxis: 'x', 'y', 'xy' options.distribution and ticks.source options.bounds option.offset scale option. Thanks @nagixcallback is now called with this as scope. Thanks @andigchartjs-color dependency to version 2.2.02 for all charts). Thanks @jtblinlabelOffset not working for vertical axes. Thanks @suheb*_SAFE_INTEGER constants. Thanks @OlduwanSteveonHover event not being triggered. Thanks @ricardocosta89layout options (empty object).round option.labels option is undefined.ticks.padding option now applies to vertical and horizontal scales.reverse option in radial linear scale.pointBorderWidth now supports array.offsetGridLines consistent. Thanks @nagixstepSize documentation (previously unitStepSize).getElementAtEvent in a click handler.valueAtIndexOrDefault behavior..js extensions when requiring a file. Thanks @let-aurnChart.helpers is now importable.Chart.platform is now importable.Chart.defaults/Ticks/Interaction are now importable.Chart.Element/elements.* are now importable.helpers.options.waitForResize helper.More details in the release PR: #4706
Version 2.6 brings better stability, improved documentation, and powerful new features to Chart.js. It's now possible to create advanced area chart th
Version 2.6 brings better stability, improved documentation, and powerful new features to Chart.js. It's now possible to create advanced area chart thanks to a new filler plugin: stacked area charts can now fill to another dataset in a configurable manner. Check out the samples to see the all the new options.
The time scale internals have been rewritten, improving performance by reducing the number of operations on each tick value. These changes also fixed a number of time scale related issues that users have been experiencing.
Our new documentation has been rewritten using GitBook and reorganized into smaller topics to improve clarity and allow topics to be more intuitively found. The online documentation is now organized by release version going forward: http://www.chartjs.org/docs/{version}/.
lineArc setting for the radial linear scale has been removed and replaced by gridLines.circular and pointLabels.display.Chart.chart has been merged in Chart.Chart.Controller has been merged in Chart.Chart.Animation.animationObject has been merged in Chart.Animation.Chart.Animation.chartInstance has been removed, use Chart.Animation.chart instead.'zero', 'top', 'bottom' fill modes has been replaced by 'origin', 'start', 'end'.item.weigth).before and after functionality to the steppedLine option. Thanks @ericnkatzbottom and y axes default to left.chart.data = {...}.chart instanceof Chart now returns true.getElementAtEvent() return type documentation.autoSkipPadding option.NaN when all datasets are hidden. Thanks @JareechangChart.PluginBase definition.native reserved keyword as a parameter name.line-customTooltips.html example scroll offset. Thanks @el-eepointRadius and pointHitRadius config for radar charts.legend: false and title: false.instanceof when reading context from iframe or a protected environment.gulp coverage task in gulp unittest --coverage.plugins folder.More details in the release PR: #4236
Version 2.5 brings some exciting new features to Chart.js. Now, configuration options can be updated at runtime (with some exceptions) just by changin
Version 2.5 brings some exciting new features to Chart.js. Now, configuration options can be updated at runtime (with some exceptions) just by changing the chart.config.options object and calling chart.update().
More powerful plugins that can be added to an individual chart (instead of globally), but also disabled on a per chart basis. This gives you fine grained control over when plugins interact with your charts. The plugins were changed to support cancelling actions by returning false from any before* plugin calls.
Two new extensions have been added: beforeEvent and afterEvent, respectively called before and after the chart responds to an input event such as a mousemove or a click. The plugin is passed a wrapped version of the event, that implements IEvent.
Chart.helpers.cancelAnimFrame method.onHover callback now has 3 parameters. The 2nd parameter is the event that triggered the hover. This was done for consistency with the onClick callback.IPlugin.afterScaleUpdate: use IPlugin.afterLayout hook instead.Chart.PlugingBase is not anymore required and is strongly discouraged, instead create/register plugins using plain JavaScript objects (see this example).rectRounded point style. Thanks @cmoelticks.padding option when measuringnull data caused incorrect tooltips for the time scale. Thanks @Jareechangdataset interaction modex-axis interaction mode was incorrect. Thanks @weareoutman.gitignore file for Bowergulp-uglify v2.0.0 to improve build speed. Thanks @jeffcareyMore details in the release PR: #3840
This version focuses on improving the interactivity of Chart.js. We have new and improved modes for interacting with the graph. For instance, you can
This version focuses on improving the interactivity of Chart.js. We have new and improved modes for interacting with the graph. For instance, you can now highlight the nearest item easily. It is also easy to define your own tooltip modes with a few simple functions. See all the new modes in the docs. Data animations when adding and removing data have been improved: points now animate in cleanly by default.
aspectRatio for each chart type (e.g. Chart.defaults.doughnut.aspectRatio = 2).displayColors option to turn off tooltip color boxes.average and nearest positioning modes.caretX and caretY properties to tooltip point.reset() the chart to its initial state.tooltips.filter option to filter tooltip items.drawBackground tooltip method. Thanks @mjeanroylabels.usePointStyle is true.maxWidth fillText() argument. Thanks @dylan-kerrmin, max and stepSize when all specified. Thanks @fewsteraoptions.events option merging.autoSkipPadding option documentation. Thanks @bretjbwatchify dependency. Thanks @fewsteraMore details in the release PR: #3551
This version adds back native bower support. We were able to get a name that matches in case with npm. bower install chart.js. Huge props to @simonbru
This version adds back native bower support. We were able to get a name that matches in case with npm. bower install chart.js. Huge props to @simonbrunel for getting our build system working and fully automated.
time.minUnit to one of the time scale units to use. #3254 Thanks @ianksMore details in the release PR: #3321
Nothing published for this version
Removed deprecated Chart.pluginService from docs and replace with Chart.plugins. #3088 Thanks @djhuistra
This release fixes a number of issues and adds a few small enhancements.
Chart.pluginService from docs and replace with Chart.plugins. #3088 Thanks @djhuistraitemSort function needs to get passed the chart data. #3127 Thanks @vermeecadrawTicks == false for a scale, the size of the scale was incorrectly calculated. #2872This release fixes a line drawing bug identified in v2.2.0 along with a few other issues.
This release fixes a line drawing bug identified in v2.2.0 along with a few other issues.
spanGaps option was turned on. #3056Starting with v2.2.0-rc.1 Chart.js uses a new build system. We no longer include the checked in files (dist folder) in the repository. When a tagged r
Starting with v2.2.0-rc.1 Chart.js uses a new build system. We no longer include the checked in files (dist folder) in the repository. When a tagged release is made, a build will occur and will be published on NPM automatically. A huge thanks to @simonbrunel for getting this set up and working.
This change means that installing via bower needs to use the bower npm resolver. Detailed instructions can be found in the docs
label mode of Chart.js V1. #2299 Thanks @MesonyxbarThickness option on the correct axis to set the thickness of a bar. #2910 Thanks @Joshuabaker2getPixelForValue function #2604 #2916spanGaps option for line chart can now be specified per chart instead of only per datasetoffsetGridLines option #2894 Thanks @moberwasserlechnerxAlign and yAlign were swapped. #2923 Thanks @jeffespnull labels affecting tooltips #2875 Thanks @MesonyxgetLabelMoment method from going out of bounds #3039 Thanks @ianksstepSize property in docs #3048 Thanks @mdewildegetElementAtEvent could return more than 1 item #2981, #2884 Thanks @IonutLaceanuspanGaps option to work with bezier curves #2812Nothing published for this version
Nothing published for this version
Fixes an issue identified in V2.1.5 where returning arrays from tooltip callbacks was broken. #2775
Fixes an issue identified in V2.1.5 where returning arrays from tooltip callbacks was broken. #2775
Converted legend and title blocks to use plugin system. This means that builds without these could be made.
Chart.pluginService has been renamed to Chart.plugins.showLine property in the dataset.labelColor callback in the tooltip to change the colors.resize, beforeDatasetsDraw, afterDatasetsDraw, beforeDatasetsUpdate, and afterDatasetsUpdate.false to cancel actions. Currently only the beforeDatasetsUpdate plugin call supports this.onResize that runs when the chart resizes.position: 'right' to the legend config to make this happen. The Horizontal Bar sample includes this.update. Thanks @NoelOConnellThis release adds a new call that plugins can use afterScaleUpdate which is useful for performing actions that require the scales to be in their final
This release adds a new call that plugins can use afterScaleUpdate which is useful for performing actions that require the scales to be in their final sizes.
gridLines.drawBorder to allow hiding the border along the edge of an axis. #2574 Thanks @Ceane
Documentation files have been improved for basic configuration and axes. See #2625null #2519This release adds a new call that plugins can use afterScaleUpdate which is useful for performing actions that require the scales to be in their final
This release adds a new call that plugins can use afterScaleUpdate which is useful for performing actions that require the scales to be in their final sizes.
afterScaleUpdate. Thanks @TarqwynFixed an issue with bars on the time scale #2492
beginAtZero is set and there is no data, the linear scale will be all positive. #2476You can now easily update the default configuration for different scale types using the updateScaleDefaults function. The new defaults you pass in will be merged with the old defaults. See https://github.com/chartjs/Chart.js/blob/master/docs/01-Scales.md#update-default-scale-config
Chart.scaleService.updateScaleDefaults(type, defaults)
This release only contains bug fixes.
This release only contains bug fixes.
generateLabelsThis release of Chart.js adds horizontal bars (big thanks to @potatopeelings) and the ability to create plugins that fit into the lifecycle of a chart
This release of Chart.js adds horizontal bars (big thanks to @potatopeelings) and the ability to create plugins that fit into the lifecycle of a chart.
dataset.metadata or dataset.metaDataset were being used. There is now a helper function to retrieve the correct meta data for a given datasetdestroy call. #2318 Thanks @Janpotnull #2176The old options will still work in this release.
tension property to lineTension. #2314 Thanks to @jachstet-searadius property to pointRadius #2314 Thanks to @jachstet-seaChart.defaults.Line renamed to Chart.defaults.line #2340 Thanks to @DaanDeMeyerChart.defaults.Bar renamed to Chart.defaults.bar #2340 Thanks to @DaanDeMeyerThe release of Chart.js 2.0.2 provides a few new enhancements . Documentation is available at http://nnnick.github.io/Chart.js/docs-v2/
The release of Chart.js 2.0.2 provides a few new enhancements . Documentation is available at http://nnnick.github.io/Chart.js/docs-v2/
The release of Chart.js 2.0.1 consists of mostly bug fixes. Documentation is available at http://nnnick.github.io/Chart.js/docs-v2/
The release of Chart.js 2.0.1 consists of mostly bug fixes. Documentation is available at http://nnnick.github.io/Chart.js/docs-v2/
callback returned null or undefinedThe release of Chart.js 2.0.0 adds many new features over version 1. Documentation is available at http://nnnick.github.io/Chart.js/docs-v2/
The release of Chart.js 2.0.0 adds many new features over version 1. Documentation is available at http://nnnick.github.io/Chart.js/docs-v2/
ticks.maxTicksLimit (#1859) Thanks @morleyzhiticks.stepSize to the linear scale. Allows setting a fixed delta between tick marks . (#1978). Thanks @robendist folder now has bundled versions that include moment.js (#2007) Thanks @tannerlinsleyxAlign and yAlign options for tooltips. (#2116). Thanks @100000001ticks.min and ticks.max support to the category scale. The value of these settings must be something in the data.labels array. #2209NaN data (#1822)suggestedMin, suggestedMax, min, and max options to radial linear scale (#1461)min and max settings for time scales (#1941)datasets object in the chart data (#2115)This release fixes a few minor bugs introduced in the v1.1.0 release:
Release notes:
This release fixes a few minor bugs introduced in the v1.1.0 release:
<span class="datasetname-legend-icon"> wraps the color box. <span class="datasetname-legend-text"> wraps the text. Thanks @eemikulaPlease take a look at the change log for a full list of the changes.
This release focused on refactoring all the animatations into an animationService as well as adding a few new features and fixing a ton of bugs. Below
This release focused on refactoring all the animatations into an animationService as well as adding a few new features and fixing a ton of bugs. Below is a list of some of the notible changes:
Chart.animationService (@etimberg).Please take a look at the change log for a full list of the changes.
We'd like to thank the community for your contributions, we couldn't do this without you! We'd also like to invite you to join our community on slack.
One column per quarter.