Skip to content

ggplot2

4.0.3Package record

Create Elegant Data Visualisations Using the Grammar of Graphics

5,005packages dependsuggested by 2,154
27.7Mdownloads / year
81.2%test coverage
8/13flavors OK

Overview

About

A system for 'declaratively' creating graphics, based on "The Grammar of Graphics". You provide the data, tell 'ggplot2' how to map variables to aesthetics, what graphical primitives to use, and it takes care of the details.

Changes in 4.0.3

This is a hotfix release fixing a test, a bug and introducing a feature.

  • Adapt to changes in rlang::warn_dots_used() (@lionel-, #6830).
  • Fixed bug where guide_axis_theta() didn't anticipate old-style text elements (#6803).
  • geom_boxplot()/stat_boxplot() gain a quantile.type parameter (default 7) to control the percentile definition used for hinges and median; set quantile.type = 2 to match SAS's default PCTLDEF = 5, enabling parity with SAS boxplots out-of-the-box. (@munoztd0, #6819)

From NEWS.md in the release

Install

Health

CRAN checks
5NOTE8OK
Check messages
NOTER code for possible problemsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64
Found calls to structure() using deprecated special names:
  ggplot2/tests/testthat/test-annotate.R (.Names: 1)
'.Names' should be changed to 'names'.
NOTERd contentsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc
Rd files without \usage:
  ‘print.ggplot.Rd’
\arguments should not be documented without \usage.

CRAN check page ↗

Slowest check: 17.5 min · r-oldrel-windows-x86_64
Status changes
  • NOTE8 OK, 5 NOTE2026-10-25
  • ERROR8 OK, 4 NOTE, 1 ERROR2026-10-24
  • NOTE12 OK, 1 NOTE2026-07-11
  • OK13 OK2026-06-08
  • WARNING12 OK, 1 WARNING2026-06-07
Show 3 earlier changesHide 3 earlier changes
  • OK13 OK2026-04-30
  • ERROR10 OK, 3 NOTE, 1 ERROR2026-04-07
  • NOTE11 OK, 3 NOTE2026-03-10
Advisories

none known

Documentation

In release 4.0.3
READMEYes · 513 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 4.0.3Citation fileYes · cites a publicationWebsiteYes · pkgdown

The repository also keeps web-only articles.

Help pages
226 (87 internal)includes a package overview page
Examples that run
93%148 run in a plain check (6 of them under a condition) · 8 only when donttest examples are enabled (R CMD check --as-cran) · 2 never run · 1 hold no code
Exported functions with examples
76%
Documented parameters
85%
Return-value docs
21%
Help pages citing references
2%

Downloads

27.7M
CRAN downloads in the past year
Rank #4 · ~76K/day · ~2.3M/mo
Daily download trend is not available in this view yet.
2M30 days
6M90 days
27.7M1 year
Compare downloads with other packages →
Also on256.5K r2u158 autocran1.8M conda_forge1.6K bioconda24.1K c2d4u

Repository

7,020Stars
2,125Forks
79Open issues
33Open PRs
30Releases
5,776Commits
384Commit identities
rvisualisationdata-visualisation
5,776 commits · Last activity 2026-10-20 · +0.2% stars, 30d · Default branch at 4.0.3.9000, ahead of CRAN 4.0.3 (checked 2026-10-25)
Responsiveness
How these are sampled
PRs merged (all time)
80%
Median days to close, 50 most recently updated closed issues
86
Median days to close, 50 most recently updated closed PRs
30

Stars over time

2025-10-24 · 6,7462026-10-26 · 7,020
PracticesBeta

18 development-tooling and community-health practices detected across 8 families in the upstream repository

Checks run against github.com/tidyverse/ggplot2 on 2026-10-25.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (4)
Code of conductContributing guideIssue templatesGovernance doc
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-20 · The repository has a site deploy workflow

pkgdown site last built 2026-04-22

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 4 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (2)
cran-comments.mdrevdep/
Lint, format, editor (3)
AirVS CodeRStudio project
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

An outside contributor's pull request to this repository was written with an AI coding tool.

From outside contributors
  • Claude Code
    Pull requests: 1 from outside contributors, first on 2025-05-23, 1 from forks
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
33 external dependencies (excludes base and recommended)

Installing ggplot2 adds 16 packages (7 with compiled code, 7.6 MB of source tarballs). Heaviest: isoband 1.5 MB, farver 1.2 MB, viridisLite 1.2 MB.

Depends (1)
R >= 4.1
LinkingTo (0)
none
Enhances (0)
none

Datasets

People & History

People (11)
Author, Maintainer since 3.3.2 (2020) · added in 3.0.0
Author · added in 0.9.2
Author · added in 3.3.0
Author · added in 3.0.0
Author · added in 3.0.0
Author · added in 3.0.0
Author · added in 3.0.0
Author · added in 3.2.0
Author · added in 3.5.0
Copyright holder, Funder · added in 3.4.2

Previously maintained by Hadley Wickham (0.5 to 3.3.1).

Listed in earlier versions (1)
RStudio
no longer listed · 2.0.0 to 3.4.1
Releases (55)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 4.0.3Latest
    record
    2026-04-22 · current release · diff ↗
  • 4.0.2
    record
    2026-02-03 · diff ↗
  • 4.0.1
    record
    2025-11-14 · diff ↗
  • 4.0.0
    record
    2025-09-11 · diff ↗ ·
    added 63 exports
    CoordTransform, GeomBin2d, StatConnect, StatManual, add_gg, annotation_borders, class_S3_gg, class_coord, class_derive, class_facet, class_gg, class_ggplot, class_ggplot_built, class_ggproto, class_guide, class_guides, class_labels, class_layer, class_layout, class_mapping, class_rel, class_scale, class_scales_list, class_theme, class_waiver, class_zero_grob, complete_theme, coord_transform, element, element_geom and 33 more
  • R
    R 4.5.0 released · 2025-04-11
  • 3.5.2
    record
    2025-04-09 · diff ↗ ·
    added 17 exports
    get_geom_defaults, get_labs, is_coord, is_facet, is_geom, is_ggplot, is_ggproto, is_guide, is_guides, is_layer, is_mapping, is_margin, is_position, is_scale, is_stat, is_theme, is_theme_element
  • R
    R 4.4.0 released · 2024-04-24
  • 3.5.1
    record
    2024-04-23 · diff ↗
  • 3.5.0
    record
    2024-02-23 · diff ↗ ·
    added 27 exports
    .expose_data, .ignore_data, CoordRadial, Guide, GuideAxis, GuideAxisLogticks, GuideAxisStack, GuideAxisTheta, GuideBins, GuideColourbar, GuideColoursteps, GuideCustom, GuideLegend, GuideNone, GuideOld, check_device, coord_radial, fill_alpha, get_guide_data, guide_axis_logticks, guide_axis_stack, guide_axis_theta, guide_custom, new_guide, old_guide, pattern_alpha, translate_shape_string
  • 3.4.4
    record
    2023-10-12 · diff ↗
  • 3.4.3
    record
    2023-08-14 · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • 3.4.2
    record
    2023-04-03 · diff ↗ ·
    added 1 export
    datetime_scale
  • 3.4.1
    record
    2023-02-10 · diff ↗ ·
    added 2 exports
    scale_linewidth_identity, scale_linewidth_manual
  • 3.4.0
    record
    2022-11-04 · diff ↗ ·
    added 10 exports
    StatAlign, draw_key_linerange, scale_linewidth, scale_linewidth_binned, scale_linewidth_continuous, scale_linewidth_date, scale_linewidth_datetime, scale_linewidth_discrete, scale_linewidth_ordinal, stat_align
Show 64 earlier eventsHide 64 earlier events
  • 3.3.6
    record
    2022-05-03 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • 3.3.5
    record
    2021-06-25 · diff ↗
  • 3.3.4
    record
    2021-06-16 · diff ↗ ·
    added 5 exports
    as_label, geom_bin_2d, get_alt_text, scale_color_viridis_b, sf_transform_xy
  • R
    R 4.1.0 released · 2021-05-18
  • 3.3.3
    record
    2020-12-30 · diff ↗
  • 3.3.2
    record
    2020-06-19 · diff ↗ ·
    added 11 exports
    GeomContourFilled, GeomDensity2dFilled, GeomFunction, StatDensity2dFilled, binned_scale, geom_density2d_filled, geom_density_2d_filled, geom_function, scale_alpha_binned, stat_density2d_filled, stat_density_2d_filled
  • 3.3.1
    record
    2020-05-29 · diff ↗
  • R
    R 4.0.0 released · 2020-04-24
  • 3.3.0
    record
    2020-03-05 · diff ↗ ·
    added 49 exports
    ScaleBinned, ScaleBinnedPosition, StatContourFilled, after_scale, after_stat, el_def, element_render, expansion, flip_data, flipped_names, geom_contour_filled, get_element_tree, guide_axis, guide_bins, guide_colorsteps, guide_coloursteps, guide_none, guide_transform, has_flipped_aes, register_theme_elements, reset_theme_settings, scale_color_binned, scale_color_date, scale_color_datetime, scale_color_fermenter, scale_color_ordinal, scale_color_steps, scale_color_steps2, scale_color_stepsn, scale_colour_binned and 19 more
  • 3.2.1
    record
    2019-08-11 · diff ↗
  • 3.2.0
    record
    2019-06-16 · diff ↗ ·
    added 2 exports
    draw_key_timeseries, layer_sf
  • R
    R 3.6.0 released · 2019-04-26
  • 3.1.1
    record
    2019-04-07 · diff ↗
  • 3.1.0
    record
    2018-10-25 · diff ↗ ·
    added 5 exports
    StatSfCoordinates, geom_sf_label, geom_sf_text, standardise_aes_names, stat_sf_coordinates
  • 3.0.0
    record
    2018-07-03 · diff ↗ ·
    added 57 exports
    .data, CoordSf, GeomSf, Layout, PositionDodge2, StatQqLine, StatSf, autolayer, coord_sf, enexpr, enexprs, enquo, enquos, ensym, ensyms, expand_scale, expr, geom_qq_line, geom_sf, ggplot_add, guide_gengrob, guide_geom, guide_merge, guide_train, merge_element, position_dodge2, quo, quo_name, quos, scale_alpha_date and 27 more
  • R
    R 3.5.0 released · 2018-04-23
  • R
    R 3.4.0 released · 2017-04-21
  • 2.2.1
    record
    2016-12-30 · diff ↗
  • 2.2.0
    record
    2016-11-11 · diff ↗ ·
    removed 1 export
    facet
    added 21 exports
    AxisSecondary, Facet, FacetGrid, FacetNull, FacetWrap, GeomCol, combine_vars, derive, dup_axis, find_panel, geom_col, max_height, max_width, panel_cols, panel_rows, render_axes, render_strips, scale_x_time, scale_y_time, sec_axis, wrap_dims
  • R
    R 3.3.0 released · 2016-05-03
  • 2.1.0
    record
    2016-03-01 · diff ↗ ·
    added 7 exports
    scale_colour_date, scale_colour_datetime, scale_fill_date, scale_fill_datetime, scale_size_date, scale_size_datetime, theme_replace
  • 2.0.0
    record
    2015-12-18 · diff ↗ ·
    removed 20 exports
    coord, ggfluctuation, ggmissing, ggorder, ggpcp, ggstructure, is.coord, opts, plotmatrix, scale_area, stat_abline, stat_bindot, stat_hline, stat_vline, theme_blank, theme_line, theme_rect, theme_segment, theme_text, update_element
    added 144 exports
    .pt, .stroke, Coord, CoordCartesian, CoordFixed, CoordFlip, CoordMap, CoordPolar, CoordQuickmap, CoordTrans, Geom, GeomAbline, GeomAnnotationMap, GeomArea, GeomBar, GeomBlank, GeomBoxplot, GeomContour, GeomCrossbar, GeomCurve, GeomCustomAnn, GeomDensity, GeomDensity2d, GeomDotplot, GeomErrorbar, GeomErrorbarh, GeomHex, GeomHline, GeomLabel, GeomLine and 114 more
  • R
    R 3.2.0 released · 2015-04-16
  • 1.0.1
    record
    2015-03-17 · diff ↗
  • 1.0.0
    record
    2014-05-21 · diff ↗ ·
    added 11 exports
    aes_q, coord_quickmap, label_wrap_gen, labeller, position_jitterdodge, scale_color_distiller, scale_colour_distiller, scale_fill_distiller, stat_ellipse, theme_light, theme_linedraw
  • R
    R 3.1.0 released · 2014-04-10
  • R
    R 3.0.0 released · 2013-04-03
  • 0.9.3.1
    record
    2013-03-02 · diff ↗
  • 0.9.3
    record
    2012-12-05 · diff ↗ ·
    added 4 exports
    gg_dep, scale_size_area, theme_classic, theme_minimal
  • 0.9.2.1
    record
    2012-09-11 · diff ↗
  • 0.9.2
    record
    2012-09-04 · diff ↗ ·
    added 12 exports
    %+replace%, calc_element, element_blank, element_line, element_rect, element_text, ggtitle, is.ggplot, is.theme, rel, stat_ecdf, theme
  • 0.9.1
    record
    2012-05-08 · diff ↗ ·
    added 2 exports
    annotation_logticks, position_identity
  • R
    R 2.15.0 released · 2012-03-30
  • 0.9.0
    record
    2012-03-01 · diff ↗ ·
    removed 1 export
    pattern:^[^\\.]
    added 214 exports
    %+%, aes_all, aes_auto, aes_string, aes, annotate, annotation_custom, annotation_map, annotation_raster, autoplot, benchplot, borders, continuous_scale, coord_cartesian, coord_equal, coord_fixed, coord_flip, coord_map, coord_polar, coord_trans, coord, cut_interval, cut_number, discrete_scale, expand_limits, facet_grid, facet_null, facet_wrap, facet, fortify and 184 more
  • R
    R 2.14.0 released · 2011-10-31
  • R
    R 2.13.0 released · 2011-04-13
  • 0.8.9
    record
    2010-12-23 · diff ↗
  • R
    R 2.12.0 released · 2010-10-15
  • 0.8.8
    record
    2010-07-05 · diff ↗
  • R
    R 2.11.0 released · 2010-04-22
  • 0.8.7
    record
    2010-03-02 · diff ↗
  • 0.8.6
    record
    2010-02-18 · diff ↗
  • 0.8.5
    record
    2009-12-16 · diff ↗
  • 0.8.4
    record
    2009-12-09 · diff ↗
  • R
    R 2.10.0 released · 2009-10-26
  • 0.8.3
    record
    2009-04-20 · diff ↗
  • R
    R 2.9.0 released · 2009-04-17
  • 0.8.2
    record
    2009-02-25 · diff ↗
  • 0.8.1
    record
    2008-12-14 · diff ↗
  • 0.8
    record
    2008-11-21 · diff ↗
  • R
    R 2.8.0 released · 2008-10-20
  • 0.7
    record
    2008-10-05 · diff ↗
  • R
    R 2.7.0 released · 2008-04-22
  • 0.6
    record
    2008-04-03 · diff ↗
  • 0.5.7
    record
    2008-01-11 · diff ↗
  • 0.5.6
    record
    2007-10-20 · diff ↗
  • R
    R 2.6.0 released · 2007-10-03
  • 0.5.5
    record
    2007-09-01 · diff ↗
  • 0.5.4
    record
    2007-07-08 · diff ↗
  • 0.5.2
    record
    2007-06-18 · diff ↗
  • 0.5.1
    record
    2007-06-10 · diff ↗
  • 0.5
    record
    2007-06-01
  • R
    R 2.5.0 released · 2007-04-24

Package metadata

First published
2007-06-01
Total releases
55 / 19 yrs
License
MIT + file LICENSE OSI · relicensed from GPL-2 | file LICENSE in 3.3.3
Minimum R
≥ 4.1
Bundled data
599 KB / 11 files
Download size
6.0 MB

Cite

Cite this package

Run in R for the authors' entry:

citation("ggplot2")

The package provides a citation file, so citation() returns the authors' own entry.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for ggplot2 version 4.0.3 [Data set]. HJJB, LLC. Data release v2026-10-26. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-26, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy