Extra Functions for 'gtsummary' Table Styling
Overview
Provides additional convenience functions for 'gtsummary' (Sjoberg et al. (2021) doi:10.32614/RJ-2021-053) & 'gt' tables, including automatic variable labeling from dictionaries, standardized missing value display, and consistent formatting helpers for streamlined table styling workflows.
Breaking Changes
- Removed
apply_labels_from_dictionary(). Useattr(data$var, "label") <- "Label"directly, or the{labelled}package for bulk attribute labeling.
New Features
extras()auto-labeling viaoptions(sumExtras.auto_labels = TRUE)and (recommended)options(sumExtras.prefer_dictionary = TRUE). Seevignette("options").extras()now bolds significant p-values (bold_p()) automatically when p-values are added.- New
headerparameter inextras()controls the label column header text (default""). - New
symbolparameter inclean_table()andextras()controls the missing value replacement string (default"---"). add_group_colors()now accepts a vector of colors (one per group) in addition to a single color for all groups.
Improvements
- Data dictionaries now use lowercase column names (
variable,description) by convention. Title-case names (Variable,Description) still work — column matching is case-insensitive. extras()now handlestbl_regressiongracefully:overallandpvalare silently ignored (regression tables already have model p-values), andbold_p()is applied automatically. No more warnings when usingextras()with default arguments on regression tables.- Removed startup message. The package now loads silently.
Show all changes in 1.0.0Hide the rest of the changes in 1.0.0
- Dropped
{purrr}from Imports (4 dependencies instead of 5). - New vignettes:
vignette("options")andvignette("themes").
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-07
- OK13 OK2026-06-04
Show 4 earlier changesHide 4 earlier changes
- ERROR10 OK, 3 ERROR2026-05-29
- OK13 OK2026-05-02
- ERROR11 OK, 1 ERROR2026-04-25
- OK14 OK2026-03-10
Documentation
- Help pages
- 9 (1 internal)includes a package overview page
- Examples that run
- 11%1 run in a plain check · 8 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 10
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Releases over time
Issues over time
PRs over time
7 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/kylegrealis/sumextras on 2026-10-22.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-07-01 · The repository has a site deploy workflow
pkgdown site last built 2026-07-01
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2025-11-12Named in .Rbuildignore: .claude, CLAUDE.mdNamed in .gitignore: .claude, CLAUDE.mdCommits: at least 5 crediting it in the message
- Gemini CLIfirst seen 2025-12-23Named in .Rbuildignore: .gemini, GEMINI.mdNamed in .gitignore: .gemini, GEMINI.md
Dependencies
Code & Tests
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 1.0.0Latest
- 0.3.02026-01-22 · diff ↗
- 0.2.02026-01-19
- RR 4.5.0 released · 2025-04-11
Package metadata
- First published
- 2026-01-19
- Total releases
- 3 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.1.0
- Download size
- 2.4 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("sumExtras")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.