The {gtsummary} package provides an elegant and flexible way to create publication-ready analytical and summary tables using the **R** programming language. The {gtsummary} package summarizes data sets, regression models, and more, using sensible defaults with highly customizable capabilities.

**Summarize data frames or tibbles**easily in**R**. Perfect for presenting descriptive statistics, comparing group**demographics**(e.g creating a**Table 1**for medical journals), and more. Automatically detects continuous, categorical, and dichotomous variables in your data set, calculates appropriate descriptive statistics, and also includes amount of missingness in each variable.**Summarize regression models**in R and include reference rows for categorical variables. Common regression models, such as logistic regression and Cox proportional hazards regression, are automatically identified and the tables are pre-filled with appropriate column headers (i.e. Odds Ratio and Hazard Ratio).**Customize gtsummary tables**using a growing list of formatting/styling functions.**Bold**labels,**italicize**levels,**add p-value**to summary tables,**style**the statistics however you choose,**merge**or**stack**tables to present results side by side… there are so many possibilities to create the table of your dreams!**Report statistics inline**from summary tables and regression summary tables in**R markdown**. Make your reports completely reproducible!

By leveraging {broom}, {gt}, and {labelled} packages, {gtsummary} creates beautifully formatted, ready-to-share summary and result tables in a single line of R code!

Check out the examples below, review the vignettes for a detailed exploration of the output options, and view the gallery for various customization examples.

The {gtsummary} package was written as a companion to the {gt} package from RStudio. You can install {gtsummary} with the following code.

`install.packages("gtsummary")`

Install the development version of {gtsummary} with:

`remotes::install_github("ddsjoberg/gtsummary")`

Use `tbl_summary()`

to summarize a data frame.

Example basic table:

```
library(gtsummary)
# make dataset with a few variables to summarize
trial2 <- trial %>% select(age, grade, response, trt)
# summarize the data with our package
table1 <- tbl_summary(trial2)
```

There are many **customization options** to **add information** (like comparing groups) and **format results** (like bold labels) in your table. See the `tbl_summary()`

tutorial for many more options, or below for one example.

```
table2 <-
tbl_summary(
trial2,
by = trt, # split table by group
missing = "no" # don't list missing data separately
) %>%
add_n() %>% # add column with total number of non-missing observations
add_p() %>% # test for a difference between groups
modify_header(label = "**Variable**") %>% # update the column header
bold_labels()
```

Use `tbl_regression()`

to easily and beautifully display regression model results in a table. See the tutorial for customization options.

```
mod1 <- glm(response ~ trt + age + grade, trial, family = binomial)
t1 <- tbl_regression(mod1, exponentiate = TRUE)
```

You can also present side-by-side regression model results using `tbl_merge()`

```
library(survival)
#> Warning: package 'survival' was built under R version 4.0.3
# build survival model table
t2 <-
coxph(Surv(ttdeath, death) ~ trt + grade + age, trial) %>%
tbl_regression(exponentiate = TRUE)
# merge tables
tbl_merge_ex1 <-
tbl_merge(
tbls = list(t1, t2),
tab_spanner = c("**Tumor Response**", "**Time to Death**")
)
```

Review even more output options in the **table gallery**.

The **{gtsummary}** package was written to be a companion to the **{gt}** package from RStudio. But not all output types are supported by the **{gt}** package. Therefore, we have made it possible to print **{gtsummary}** tables with various engines.

Review the **gtsummary + R Markdown** vignette for details.

Please note that the {gtsummary} project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms. A big thank you to all contributors!

@ablack3, @aghaynes, @ahinton-mmc, @alexis-catherine, @anaavu, @angelgar, @asshah4, @barthelmes, @benediktclaus, @calebasaraba, @CarolineXGao, @CodieMonster, @ctlamb, @davidgohel, @davidkane9, @dax44, @ddsjoberg, @DeFilippis, @denis-or, @djbirke, @emilyvertosick, @gorkang, @GuiMarthe, @hughjonesd, @IsadoraBM, @j-tamad, @jalavery, @jeanmanguy, @jemus42, @jennybc, @JeremyPasco, @JesseRop, @jflynn264, @jjallaire, @joelgautschi, @juseer, @jwilliman, @karissawhiting, @khizzr, @kmdono02, @larmarange, @leejasme, @ltin1214, @margarethannum, @Marsus1972, @matthieu-faron, @mbac, @MelissaAssel, @michaelcurry1123, @moleps, @MyKo101, @oranwutang, @Pascal-Schmidt, @proshano, @ryzhu75, @sammo3182, @sbalci, @simonpcouch, @slb2240, @slobaugh, @storopoli, @tjmeyers, @tormodb, @UAB-BST-680, @Uriahf, @zabore, and @zeyunlu