Highcharts React v5.2.0 introduces full support for highcharts v13.0.0.
- Capped the Highcharts peer dependency at v13 (
^13.0.0). - Introduced DataTable and Palette option components.
- Fixed Chart component's direct props and
optionsmerging. - Fixed Chart component's option resolution order so child components (e.g.
<Title>) take precedence over direct props andoptions. - Fixed missing
SeriesTypeexport and improved generic typing for the Series component'stype-specific fields. - Fixed Tooltip component incorrectly serializing a single
data-hc-optionchild totooltip.formatinstead of binding it to its named sub-option (e.g.pointFormat). - Surfaced the changelog in a few more places for better visibility.
- Adjusted the Tooltip component docs to mention the
useHTMLdefault.
- Capped the Highcharts peer dependency at v12 (
^12.0.0). - Added Highcharts version tags to JSDoc blocks.
- Fixed
Highchartsimport in the Bundling and tree shaking article. - Fixed missing and mismatched additional modules for series components. Closes highcharts/highcharts-react#557, highcharts/highcharts-react#573.
- Fixed primitive types being dropped from union types in generated components.
- Added the v5 migration guide to the highcharts-react Claude skill.
- Fixed missing heatmap module import for the
HeatmapSeriescomponent.
Highcharts React v5.0.0 introduces breaking changes to module import paths, ESM bundling, Vite compatibility, and type naming. See the v5 migration guide for quick migration steps.
- Migrated source modules to pure ESM paths (read more under Bundling and tree shaking).
- Added support for component wrapping.
- Added support for the most common series component options as props (
id,index,name,type,className,color,events,data). - Extended the
Chartcomponent with common options exposed as props (subtitle,caption,credits,type,height,width,inverted,animation,styledMode,backgroundColor,borderColor,margin,spacing,colors). PlotOptionsnow supports specific series keys (line,column) in addition to the genericserieskey.- Implemented module components for
Boost,BrokenAxis,DraggablePoints, andStockTools(closes highcharts/highcharts-react#560).
- Fixed missing TypeScript type definitions for several component options.
- Removed incorrectly referenced source maps (closes highcharts/highcharts-react#568).
- Fixed series updates to keep custom series props and avoid extra chart updates.
- Fixed nested series options to correctly merge parent and child option objects.
- Removed the
typeprop from dedicated series components (for example,LineSeriesandColumnSeries). - Fixed
Highcharts.setOptions()to apply chart options globally. - Fixed mapped props generation to avoid injecting
undefinedvalues into options, preserving Highcharts defaults when props are omitted. - Fixed array types (closes highcharts/highcharts-react#559).
- Fixed CSS-related types and doclet state generation (closes highcharts/highcharts-react#567).
- Fixed README.md elements alignment.
- Added documentation for all React components available in the integration.
- Improved chart updates by reducing unnecessary re-renders.
- Removed ts declaration for series children prop.
- Prevented rendering errors in server-side environments.
- Improved our migration guide from v3.
- Disabled data mutation by default (controlled by allowMutatingData set to
false). - Implemented a
Drilldowncomponent. Closes highcharts/highcharts-react#546. - Narrowed generic
Seriescomponentoptionsprop to its corresponding type. Closes highcharts/highcharts-react#541. - Replaced
renderToStaticMarkupwith a customrenderToHTMLfunction. Closes highcharts/highcharts-react#544.
- Official release of v4!
- Removed indicators from
/seriesdirectory - We have published a migration guide from v3
- Please open issues and let us know where you would like us to take this next.
- Added support for providing options as arrays. Closes highcharts/highcharts-react#532.
- Replaced internal
refaccess withforwardRefto avoid React v18 warnings. Closes highcharts/highcharts-react#529. - Used Highcharts.merge to merge in new options when updating components
- Call chart.update with
oneToOneoption set to true - Changed naming of files and exports in
/series/to have consistent casing with Highcharts. - Stock indicators have been moved from
/series/to/indicators/
- Fixed issues with series components relying on bundles such as
highcharts-more
- Changed the
containerproperty for the passedrefto be the container element and not the internal ref - Added back
containerPropsprop from previous versions
- Changed the type of the
refprop toReact.ref - Removed debug logging by default. Logging can be enabled using the
Loggerobject exported from i.e.Highcharts.jsx
-
Added the
refprop to theChartcomponents, which will be assigned to the chart instance and container element as in previous versions. Example:import { Chart } from '@highcharts/react'; function RefExample() { const ref = useRef(); useEffect(() => { if (ref.current.chart) { // Do something with the chart instance } }, []); return <Chart ref={ref} />; }
Initial beta of the reworked Highcharts React integration.