Skip to content

ggguides

1.1.10Package record

Simplified Legend and Guide Alignment for 'ggplot2'

0packages depend
2.8Kdownloads / year
91.5%test coverage
13/13flavors OK

Overview

About

Provides one-liner functions for common legend and guide operations in 'ggplot2'. Simplifies legend positioning, styling, wrapping, and collection across multi-panel plots created with 'patchwork' or 'cowplot'.

Changes in 1.1.10

Bug Fixes

  • legend_style(by = <aes>, justification = ...) collided when two or more legends shared the same edge. The 1.1.9 fix routed each call to a single global theme(legend.justification.<side> = ...), so the second call overwrote the first — legend_style(by = "colour", justification = "left") + legend_style(by = "fill", justification = "right") on the top edge ended up with both legends pinned to the right. Per-legend justification now also stashes the requested rail position on the plot and rewrites the guide-box-<side> internal gtable at render time so each legend sits at its own fraction of the rail. The render-time path also reorders the guides so the gtable cell order matches the requested rail order. The global theme write is kept as a fallback for the single-legend case. (reported by Youtao)

Internal

  • The render-time gtable post-processor checks ggplot2's guide-box layout shape (column count and pad-cell unit type) and falls back to the previous behavior with a one-shot warning if it doesn't match what ggguides was tested against (currently ggplot2 4.0.3) — so a future ggplot2 internal change degrades gracefully instead of producing wrong output.
  • If a guide already has an explicit guide_legend(order = N) set, per-legend justification reordering on that side is skipped and a warning is emitted, so the user-supplied order is never silently overwritten.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 6.0 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-06-09
  • ERROR12 OK, 1 ERROR2026-06-08
  • WARNING12 OK, 1 WARNING2026-06-07
Show 1 earlier changeHide 1 earlier change
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.1.10
READMEYes · 720 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 1.1.10Citation fileNoWebsiteYes · pkgdown
Help pages
34 (9 internal)includes a package overview page
Examples that run
100%25 run in a plain check
Exported functions with examples
100%
Documented parameters
99%
Return-value docs
100%
Help pages citing references
0%

Downloads

2.8K
CRAN downloads in the past year
Rank #14,306 · ~8/day · ~234/mo
Daily download trend is not available in this view yet.
28330 days
84090 days
2.8K1 year
Compare downloads with other packages →
Also on68 r2u4 autocran

Repository

6Stars
0Forks
0Open issues
0Open PRs
7Releases
129Commits
2Commit identities
crandata-visualizationdatavizggplot2ggplot2-extensionlegendpatchworkr
129 commits · Last activity 2026-10-23 · +20% stars, 30d
Responsiveness
not measured

Stars over time

2026-01-11 · 12026-10-13 · 6
PracticesBeta

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

Checks run against github.com/gcol33/ggguides 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

Docs source (3)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-23

Coverage (1)
Coverage reporting
Research and citation (1)
CITATION.cff
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2025-12-15
    Named in .Rbuildignore: CLAUDE.md
    Named in .gitignore: CLAUDE.md
    Commits: at least 104 crediting it in the message
Models named in its commits
  • Claude Opus 4.566 commits · Dec 2025 to Jan 2026
  • Claude Opus 4.720 commits · Apr to May 2026
  • Claude Opus 5.57 commits · Oct 2026
  • Claude Opus 4.86 commits · May to Jun 2026
  • Claude Fable 52 commits · Jun 2026

3 more models not listed. Some of these counts are a minimum, because the search stopped before the oldest commits.

Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
8 external dependencies (excludes base and recommended)

Installing ggguides adds 18 packages (7 with compiled code, 14 MB of source tarballs). Heaviest: ggplot2 6.0 MB, isoband 1.5 MB, farver 1.2 MB.

Depends (0)
none
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

People & History

People (1)
Author, Maintainer since 1.1.4 (2026)
Releases (4)

Pick two releases to compare their code metrics.

Package metadata

First published
2026-01-09
Total releases
4 / 1 yrs
License
MIT + file LICENSE OSI
Download size
581 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("ggguides")
Colling, G. (2026). ggguides: Simplified Legend and Guide Alignment for 'ggplot2' (Version 1.1.10) [Computer software]. https://doi.org/10.32614/CRAN.package.ggguides

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

The repository also keeps a CITATION.cff.

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 ggguides version 1.1.10 [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