A Wrapper for the 'Highcharts' Library

A wrapper for the 'Highcharts' library including shortcut functions to plot R objects. 'Highcharts' < http://www.highcharts.com/> is a charting library offering numerous chart types with a simple configuration syntax.

Project Status: Active - The project has reached a stable, usable state and is being actively developed. CRAN_Status_Badge downloads travis-status AppVeyor Build Status Github Stars

R wrapper for highcharts. highcharter bring all the highcharts capabilites so it is recommended know how highcharts API works to take a major advantage of this package. You can look some demos charts and explore chart types, syntax and all what highcharts can do.

  • Various chart type with the same style: scatters, bubble, line, time series, heatmaps, treemap, bar charts, networks.
  • Chart various R object with one function. With hchart(x) you can chart: data.frames, numeric, histogram, character, density, factors, ts, mts, xts, stl, ohlc, acf, forecast, mforecast, ets, igraph, dist, dendrogram, phylo, survfit classes.
  • Support Highstock charts. You can create a candlestick charts in 2 lines of code. Support xts objects from the quantmod package.
  • Support Highmaps charts. It's easy to create choropleths or add information in geojson format.
  • Themes: you configurate your chart in multiples ways. There are implemented themes like economist, financial times, google, 538 among others.
  • Plugins: motion, drag points, fontawesome, url-pattern, annotations.
  • <3 and respect to Highcharts team.



Highcharter has a dependency on Highcharts, a commercial JavaScript charting library. Highcharts offers both a commercial license as well as a free non-commercial license. Please review the licensing options and terms before using this software, as the highcharter license neither provides nor implies a license for Highcharts.

Highcharts (http://highcharts.com) is a Highsoft product which is not free for commercial and Governmental use.

Discount for highcharter users

Highsoft provide a discount to the highcharter users. It is a 50% discount on our Single Developer license. More details in http://announcements.highcharts.com/foss/.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


highcharter 0.5.0

Breaking changes

  • hchart.data.frame now gains a new mapping argument using hcaes function to define the aesthetics. After hchart(df, "line", x = xvar, yvar, group = othervar) now: hchart(df, "line", hcaes(x = xvar, yvar, color = othervar), ...) and therefore ... are used like other highcharter functions for give highcharts arguments to the series. See charting data frames vignette.

New Funcionalities

  • hc_add_series is a generic generic function (#213).

  • New hcmap function to chart maps (#218). And use remote sources (#215).

  • New charting data frames vignette (http://rpubs.com/jbkunst/230276) (#220).

  • New charting maps vignette (http://jkunst.com/highcharter/highmaps.html) (#218).

  • debug as an option instead of argument. Example options(highcharter.debug = TRUE) (#216).

  • Upgrade to highcharts V5 (#154) (#208).

  • Added helpers & shorcuts for tooltip: sort and table (#206).

  • Added export-csv plugin to export chart data to CSV, XLS, HTML or JS array (#178).

  • Added Grouped Categories pluging (#172) (#193).

  • Added Tooltip delay pluging (#181).

  • Added is.highchart according with Best practices in http://adv-r.had.co.nz/S3.html (#179).

  • New themes: theme_firefox (#191), theme_tufte (#190). hc_theme_elementary (#184).

  • hchart.data.frame doesn't override the color if the colum var have a hexadecimal color format (#148).

  • Added hc_size function to change width and height (#146).

  • Add more data for nice examples: vaccines, weather radials, pkmn (#145).


  • renaming hcwaffle to hciconarray. The hcwaffle do not make a waffle! (#242).

  • removing colize_vector function (#237).

  • viridisLite moved from imports to suggests (#236).

Bug fixes

  • Fix map using mapbubble (#209).

  • hc_add_series_map don't remove additional data (#188) (#189).

  • hc_annotations accept multiple arguments (#171).

  • Adding specific version of tibble (#159).

  • hchart.data.frame allow change stops in hc_colorAxis (#147).


  • Remove underscore as dependencies (#214) (#210).

highcharter 0.4.0

New Funcionalities

  • Include elementId to createWidget. Add the hc_elementId() to modify this paramter after the creation of the highchart object (#140).

  • hchart support data frames a la ggplot2::qplot (#136).

  • hchart support Principal Components objects princomp and prcomp charting a biplot. Thanks to @nuno-agostinho (#128 #123).

  • hchartsupport matrix objects charting a heatmap (hchart.matrix) (#86).

  • hchart support phylo objects (#64).

  • New hcboxplot, hcwaffle, hcbar, hcpie, hchist, hcdensity, hcts function to get quick some style of charts. Thanks @nuo-agostinho fo hc_add_series_density implementation (#99 #70).

  • New hc_add_series_bwp to chart box and whisker plots (#81).

  • New hc_add_series_list to add list of series (#68).

  • New hc_add_series_df_old (!!) shortcut of hc_add_series(data = list.parse3(df)) (#76).

  • Added hc_theme_sparkline (#132).

  • Added function to create dataClasses and stops arguments in hc_colorAxis (#120).

  • Validate length of data = 1 and apply the list function (#119 #188 #65 #71).

  • Added colorize function so colorize_vector will be deprecate in the next release (#75).

  • Adding hc_add_series_df similar to hchart.data.frame (#114 #115).

  • Annotation funcionalities hc_annotations (#103).

  • Added cross as marker symbol (#96).

  • New hc_yAxis_multiples to add automatically arbitraty number of y axis (#90 #79).

  • New hc_grid to create a grid of highchart objects, inspired from mjs_grid (#67 #66).

  • Add motion plugin http://www.highcharts.com/plugin-registry/single/40/Motion (#62).


  • Upgrading to highcharts 4.2.4 (#72).

  • Options were separated into highcharter.global, highcharter.lang and highcharter.chart instead of having all in one big list (#77 #52).

  • list.parse2 and list.parse3 deperacted and renaming to list_parse2 and list_parse3.

  • hc_add_series_scatter is more flexible and general (#54 #58)

Bug fixes

  • .hc_get_fonts now handle fonts names with multiple spaces (#107).

  • hchart.character now display empty levels (#101).

  • datetime_to_timestampdon't break in certain cases (#97).


  • At startup a message disply mentioning that highchart, highstock and highmaps are not free for commercial and Governmental use.


  • Adding underscore dependency (previously was removed. Solves #28)

highcharter 0.3.0

  • Igraph support to hchart (#61)

  • New function export_hc. Take a highchart object and write a js file with the options (#60).

  • New function tooltip_table. Helper to create table based in tags from htmltoolspackage #59).

  • New function hc_colors. Function for the colors option in highcharts api (#57).

  • Adding funnel.js and gauge-solid.js to depedenci for create funnel charts and charts like apple watch (#56).

  • The hc_themes_... functions gains a ... parameter to add styles to the current invoked theme (#53).

  • More themes: flat, flatdark, smpl, ft (financial times) (#49).

  • Dont run error (\dontrun{}) to avoid quantmod package example in flags function

highcharter 0.2.0

  • Implemenation of highcharts with boost module highchart2() (#43). This include highcharts.js, exporting.js and boost-module.js.

  • Highstock implementation/support (#10)

  • Highmaps implementation/support (#25)

  • Adding themes (#35): 538, economis, dotabuff, google, theme null (#19)

  • Plugins: Add font awesome integration (#45), fill-pattern (#31), draggable-points (#28)

  • New hchart function. Generic function to chart acf, forecast, ts, stl, xts, ohcl objects (#2) (#27)

  • In highmaps prevent scrolling when cursor is over the map (#38)

  • Import rex-export %>% (#15)

  • Heigth scale in the container in rstudio IDE (#14)

  • Avoid duplicate css calls (#6)

  • Add uscountygeojson, usgeojson, worldgeojson, unemployment data

highcharter 0.1.0

  • Data: city temp. favorite bars, favorite pies.

  • Shortcuts to plot scatters, bar, pies, treemaps and time series

  • Addging theme and options HC funcionalities

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.7.0 by Joshua Kunst, 7 days ago


Report a bug at https://github.com/jbkunst/highcharter/issues

Browse source code at https://github.com/cran/highcharter

Authors: Joshua Kunst [aut, cre] , Nuno Agostinho [ctb] (hchart.survfit , densities and hc_add_series_scatter) , Danton Noriega [ctb] (hcaes_) , Martin John Hadley [ctb] (hc_add_event_point improvement) , Eduardo Flores [ctb] (First version hc_add_series_df_tidy) , Dean Kilfoyle [ctb] (First version hc_add_series_boxplot) , Adline Dsilva [ctb] (First version Matrix heatmap) , Kamil Slowikowski [ctb] , Christian Minich [ctb] (hcaes mutate_mapping improvement) , Jonathan Armond [ctb] (mutate_mapping bugfix)

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports htmlwidgets, magrittr, purrr, rlist, assertthat, zoo, dplyr, tibble, stringr, broom, xts, quantmod, tidyr, htmltools, jsonlite, igraph, lubridate, crosstalk, yaml, rlang, whisker

Suggests knitr, rmarkdown, survival, ggplot2, httr, viridisLite, shiny, MASS, gapminder

Suggested by fivethirtyeight, shinyjqui, xplorerr.

See at CRAN