ggpubr

Overview

About

Maintained by Alboukadel KassambaraFirst published 2016-07-2024 releasesCRAN page ↗GitHub ↗

The 'ggplot2' package is excellent and flexible for elegant data visualization in R. However the default generated plots require some formatting before we can send them for publication. Furthermore, to customize a 'ggplot', the syntax is opaque and this raises the level of difficulty for researchers with no advanced R programming skills. 'ggpubr' provides some easy-to-use functions for creating and customizing 'ggplot2'-based publication ready plots. This version includes modern R ecosystem compatibility updates and customizable p-value formatting presets (APA, AMA, NEJM, Lancet, GraphPad, and scientific notation) for publication workflows, plus robust sparse-subset handling in statistical annotation layers such as 'stat_compare_means()' and 'geom_pwc()', with informative per-group skip diagnostics for non-comparable subsets.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("ggpubr", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("kassambara/ggpubr")

Development version from kassambara/ggpubr. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-ggpubr

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-ggpubr

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-ggpubr

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

2NOTE11OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-clang
NOTE r-devel-linux-x86_64-debian-gcc

Slowest check: 15.0 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 0.37

64.5%

Coverage · measured lines

99%

Documentation · exports

19

Dependencies · direct

Check history

NOTE2026-07-11
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-07
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-06-03
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-05-25
11 OK · 0 NOTE · 0 WARNING · 2 ERROR · 0 FAILURE

Show 1 earlier snapshots

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 443 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 94%
Documented parameters: 92%
Return-value docs: 27%
References docs: 1%

Downloads

3M

CRAN downloads in the past year

Rank #211 · ~8.3K/day · ~251.4K/mo

Releases R versions

Daily download trend is not available in this view yet.

231.6K30 days

791.9K90 days

3M1 year

Compare downloads with other packages →

Also on15.7K r2u22 autocran73.4K conda_forge1.6K c2d4u

Repository

GitHub ↗ kassambara/ggpubr

1,252Stars

180Forks

1Open issues

0Open PRs

24Releases

1,199Commits

9Contributors

1,199 commits · Last activity 2026-07-13 · +0.4% stars, 30d

Stars over time

2025-07-22 · 1,1782026-07-18 · 1,251

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/kassambara/ggpubr on 2026-07-19.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Lint, format, editor (1)

RStudio project

Governance and community (1)

Issue templates

Git structural (1)

.gitattributes

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

20 external dependencies (excludes base and recommended)

Depends (2)

R >= 4.1.0ggplot2

Imports (18)

ggrepelgridggscistatsutilstidyr (>= 1.3.2)purrr dplyr cowplot ggsignif scales gridExtra glue polynom rlang rstatix (>= 1.0.0)tibble magrittr

LinkingTo (0)

none

Suggests (5)

grDevicesknitr RColorBrewer gtable testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

319direct

114indirect

and 271 more packages.

Code & Tests

Code Composition

R 26,265 (69%)Rd 11,825 (31%)

Code characteristics

Object systems

S34

Cyclomatic complexity: 2.0 median / 46 max
Test cases: 466 / 0.37 per code line

Test coverage

Line coverage

64%

Expression

63.6%

Tests / Examples

64.5% / 72% ex

Functions

371 122 exported

Complexity

4.7 avg / 46 max

Call network

371 nodes / 585 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

371 functions

Function	Cyclo	Coverage
as_npcx exp	1	0%
as_npcy exp	1	0%
background_image exp	1	0%
bgcolor exp	1	0%
border exp	1	0%
change_palette exp	1	0%

Datasets

Bundled datasets · 3

Name	Class	Rows × Cols	Also ships in
diff_express	data.frame	36,028 × 5	–
gene_citation	data.frame	66 × 2	–
gene_expression	tbl_df/tbl/data.frame	1,305 × 5	–

People & History

People (2)

Maintainer (1)

Alboukadel Kassambara

Author, Maintainer

Authors (1)

Alboukadel Kassambara

Author, Maintainer

Contributors (1)

Laszlo Erdey

Contributor · added in 0.6.3

Package Timeline

24 releases. Pick two to compare their code metrics. R releases are shown for context.

1.0.0Latest
2026-07-06 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
0.6.3
2026-02-24 · diff ↗
0.6.2
2025-10-17 · diff ↗
0.6.1
2025-06-27 · diff ↗
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
R
R 4.3.0 released · 2023-04-21
0.6.0
2023-02-10 · diff ↗
0.5.0
2022-11-16 · diff ↗
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
0.4.0
2020-06-27 · diff ↗
0.3.0
2020-05-04 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.2.5
2020-02-13 · diff ↗

Show 19 earlier events

0.2.4
2019-11-14 · diff ↗
0.2.3
2019-09-04 · diff ↗
0.2.2
2019-08-07 · diff ↗
0.2.1
2019-06-23 · diff ↗
R
R 3.6.0 released · 2019-04-26
0.2
2018-11-15 · diff ↗
0.1.9
2018-11-11 · diff ↗
0.1.8
2018-08-30 · diff ↗
0.1.7
2018-06-23 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.1.6
2017-11-14 · diff ↗
0.1.5
2017-08-22 · diff ↗
0.1.4
2017-06-28 · diff ↗
0.1.3
2017-06-06 · diff ↗
R
R 3.4.0 released · 2017-04-21
0.1.2
2017-03-14 · diff ↗
0.1.1
2016-12-05 · diff ↗
0.1.0
2016-07-20
R
R 3.3.0 released · 2016-05-03

Package metadata

First published: 2016-07-20
Total releases: 24 / 10 yrs
License: GPL (>= 2) OSI
Minimum R: ≥ 4.1.0
Bundled data: 779 KB / 3 files
Download size: 1.6 MB
Installed size: not tracked yet
With dependencies: not tracked yet