TL;DR

Chart.js now correctly handles zoom levels in Chrome and synchronizes legend options for doughnut charts, improving visual accuracy and consistency.

Fixes Worth Knowing

• Charts no longer shrink unexpectedly when zooming in Chrome.
• Doughnut chart legends now consistently reflect chart options.
• Plugin uninstallation is handled more reliably, preventing errors.

Before You Upgrade

Ensure your TypeScript definitions are updated to include the new data.datasets[].tooltip.callbacks and drawingArea properties.

TL;DR

Chart.js v4.0 introduces significant TypeScript improvements and fixes rendering issues, particularly for doughnut and pie charts, enhancing stability and developer experience.

Breaking

• Dataset type specification has changed (affects how chart data is defined).
• Helpers.options have been migrated to TypeScript (may impact custom option handling).

New

• Colors plugin now works with pie charts (allows for more flexible color schemes).
• Improved documentation with getting started guides (simplifies onboarding for new users).

Fixes Worth Knowing

• Doughnut charts now consistently draw full arcs and borders (improves visual clarity).
• Legend label colors are now applied correctly (fixes a visual bug).
• Month display in charts is corrected (improves data accuracy).

Before You Upgrade

• Review the v4 migration guide to update your chart configurations.

TL;DR

Chart.js now supports dot notation in object keys when parsing options, improving flexibility for complex configurations.

New

• Added a circular property to arc elements for creating circular progress bars.
• Border dashes are now scriptable in grid lines.

Fixes Worth Knowing

• Resolved an issue where visible points weren’t calculated correctly during updates.
• Fixed a bug where boxWidth was incorrectly passed, affecting point styling.
• Improved parsing to handle dots in object keys (e.g., option.nested.value).

Before You Upgrade

If you rely on custom option parsing, review the changes to ensure compatibility with dot notation.

TL;DR

Chart.js v3 introduces a redesigned event system, removing old interaction overrides and the hover.onHover option, requiring users to update their event handling logic.

Breaking

• Removed line interaction overrides and hover.onHover (event handling).

Fixes Worth Knowing

• Pie charts now handle NaN data and animations correctly.
• Time scales display offsets accurately with limited data.
• Pixel alignment in scales is improved at low widths.
• Resolved issues with event replay loops and bubble chart overflow.

Before You Upgrade

• Review the migration guide to update your event handling code due to changes in the event system.

TL;DR

Chart.js 2.9.4 is the final v2 release, focusing on critical bug fixes to improve stability and security.

Fixes Worth Knowing

• Fixed issues causing crashes when calculating label sizes.
• Resolved problems with charts failing to render correctly when dimensions were invalid.
• Improved documentation for using Chart.js with Moment.js (JavaScript date/time library).

Before You Upgrade

If you are starting a new project, plan to migrate to Chart.js 3.x as v2 is no longer actively maintained.

No release notes content available to summarize.

TL;DR

Chart.js now includes new chart types (StackedArea, Radial) and customization options, improving flexibility for visualizing data.

New

• Added StackedArea chart type for visualizing cumulative data.
• Radial charts now support background colors per axis.
• Line and Radar charts gained offsetGridLines and angleLineInterval options for finer control.

Fixes Worth Knowing

• Pie charts now use a better default color palette and handle missing color definitions.
• Tooltips can now be customized with a title template.
• Fixed issues with legend templates and chart size calculations.

TL;DR

Chart.js now handles missing data and prevents chart lines from extending beyond the visible chart area, improving data visualization clarity.

New

• Support for sparse datasets: pass null to skip drawing a data point/bar.
• Bezier curves are now capped to scale bounds, preventing lines from extending outside the chart.

Fixes Worth Knowing

• Chart lines no longer extend beyond the visible chart area.

TL;DR

Chart.js now supports line and bar charts with configurable datasets, enabling more diverse data visualization.

New

• Added support for line charts.
• Added support for bar charts.
• Datasets are now configurable, allowing customization of appearance and data.

Fixes Worth Knowing

• Fixed a bug where charts wouldn't render correctly in older versions of Internet Explorer.
• Resolved an issue with incorrect label positioning on some chart types.

Package: Chart.js Release:

--- v0.3.0 (2014-07-15) --- Version 0.3.0

Breaking

• The data option now expects an array of datasets instead of a single dataset (requires code updates to existing chart configurations).

New

• Added radar charts for visualizing multivariate data (useful for comparing multiple characteristics).
• Pie and doughnut charts now support custom tooltips (pop-up text on hover).

Fixes Worth Knowing

• Improved responsiveness for charts displayed on smaller screens.
• Fixed a bug causing errors when using very large datasets.

Before You Upgrade

• Update your chart configurations to use an array of datasets in the data option.

Package: Chart.js Release:

--- v0.4.0 (2014-08-01) --- Version 0.4.0

Breaking

• Removed the deprecated scaleOverride option; use scales instead (affects chart scaling behavior).

New

• Added polar area charts for representing proportional data (similar to pie charts).
• Introduced a new events system for handling chart interactions (allows custom actions on clicks, hovers, etc.).

Fixes Worth Knowing

• Improved performance when updating charts with dynamic data.
• Fixed a bug where chart labels would overlap in certain scenarios.

Before You Upgrade

• Replace any uses of scaleOverride with the scales option in your chart configurations.

---

TL;DR

Chart.js now supports a wider range of chart types – line, bar, radar, pie, doughnut, and polar area – and offers greater customization through configurable datasets and a new events system.

Breaking

• The data option now requires an array of datasets.
• The scaleOverride option has