Joyplots in 'ggplot2'

Joyplots provide a convenient way of visualizing changes in distributions over time or space. This package enables the creation of such plots in 'ggplot2'.

Build Status Coverage Status CRAN_Status_Badge CRAN_Downloads_Badge

The ggjoy package has been deprecated. Please switch over to ggridges. To port from ggjoy to ggridges, make the following substitutions in your code:

ggjoy function ggridges function
geom_joy geom_density_ridges
geom_joy2 geom_density_ridges2
geom_joy_gradient geom_density_ridges_gradient
stat_joy stat_density_ridges
theme_joy theme_ridges

All other ggjoy functions (e.g., geom_ridgeline) exist under the same name in the ggridges package.


ggjoy 0.4.1

  • Package has been stripped down to the absolute minimum needed to reexport ggridges functions under their old names.

ggjoy 0.4.0

  • All code has been moved over to package ggridges. As of this version, ggjoy simply calls ggridges and re-exports relevant functions under the old name.


  • Added an option to center axis labels to theme_joy().

ggjoy 0.3.0

  • Added cyclical scales that make it easy to alternate between fill colors and other aesthetics.

ggjoy 0.2.0

Numerous improvements:

  • New stat binline that can be used to draw histogram joyplots.
  • Various improvements in stat_joy. In particular, it now works properly with multiple panels. It also now has parameters from and to to limit the range of density estimation, just like density().
  • Improvements in the vignettes
  • New geoms geom_ridgeline_gradient and geom_joy_gradient that can handle gradient fills.

ggjoy 0.1.0

First complete implementation ready for initial release

Reference manual

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


0.4.1 by Claus O. Wilke, 2 years ago

Browse source code at

Authors: Claus O. Wilke [cre, aut]

Documentation:   PDF Manual  

GPL-2 | file LICENSE license

Imports ggplot2

Depends on ggridges

Suggests knitr, rmarkdown

See at CRAN