gt

Build display tables from tabular data with an easy-to-use set of functions. With its progressive approach, we can construct display tables with a cohesive set of table parts. Table values can be formatted using any of the included formatting functions. Footnotes and cell styles can be precisely added through a location targeting system. The way in which 'gt' handles things for you means that you don't often have to worry about the fine details.

Releases

20

Needs compilation

No

Needs R

>= 4.1.0

Config/Needs/coverage

officer

Config/Needs/website

quarto

Config/roxygen2/version

8.0.0

Config/testthat/edition

3

Config/testthat/parallel

true

LazyData

true

RoxygenNote

7.3.3

• Reproducible Research

• Presentation tables, core

Since March 2026

• base64enc
• bigD
• bitops
• cli
• commonmark
• dplyr
• fs
• glue
• grDevices
• htmltools
• htmlwidgets
• juicyjuice
• magrittr
• markdown
• reactable
• rlang
• sass
• scales
• tidyselect
• vctrs
• xml2

Installing it adds

54 packages, 32.4 MB of source

Of those, need compilation

28

• bit64
• farver
• fontawesome
• ggplot2
• grid
• gtable
• katex
• knitr
• lubridate
• magick
• officer
• paletteer
• RColorBrewer
• rmarkdown
• rsvg
• rvest
• shiny
• testthat
• tidyr
• webshot2
• withr

Lines by kind (131,169)

Lines by language

Languages are counted from file extensions.

Files

436

R functions

1,145

Object systems

S3: 56 methods

Median

2

Mean

4.2

Highest

142

Median lines per function

17

R functions

1,145

Calls

3,277

Unconnected

49

Groups

9

Lines counted

28,433

Lines the tests ran

7,631

Tests passed

Yes

Measured with

covr 3.6.5 on R 4.6.1

Has tests

Yes

Test frameworks

testthat, tinytest

Test cases

207

Snapshot tests

14

Lines of tests

7,532

Test lines per line of code

0.09

README

No

Release notes file

Yes

Help pages

216

Lines of documentation

39,396

• RStudio

Commits

9,575

Open pull requests

20

Tagged releases

20

Latest tagged release

v1.4.0, 15 Oct 2026

In development

Default branch at 1.4.0.9000, ahead of CRAN 1.4.0 (checked 2026-10-25)

Issues closed in

1,374 days (median)

Pull requests closed in

0 days (median)

Pull requests merged

93%

Created

20 Mar 2018

Licence file reads as

–

Method, repository practices

Across rstudio

New features

• The new rows_hide() and rows_unhide() functions control row visibility, mirroring cols_hide() and cols_unhide(). Hidden rows are excluded from the rendered table but can still be targeted in rows expressions, and summary rows are calculated from the visible rows only. (#2127)
• Numeric formatting functions (fmt_number(), fmt_scientific(), fmt_engineering(), fmt_percent(), fmt_currency(), and others) gain a drop_leading_zero argument. Setting this to TRUE removes the leading zero from values between -1 and 1 (e.g., 0.75 becomes .75), which is useful for displaying correlations, p-values, and other bounded statistics (#2146). (#2155)
• Tables can now be saved as PowerPoint files with gtsave() by using the .pptx file extension. This is powered by a new OOXML rendering engine that aims to unify Word and PowerPoint output (#97). (@thebioengineer, @romainfrancois, #2158)
• gt_group() can now combine gt_group objects with gt_tbl objects (#2128). (@shannonhaughton, #2129)
• Tables with no data rows now display a locale-appropriate message (e.g., "Table has no data") in the body area for both HTML and LaTeX output. The message can be customized via tab_options(table.no_data_message = "...") or suppressed by setting it to "" (#1881).

Upcoming changes

• gt's internals and documentation now use the base pipe (|>) throughout. gt still re-exports %>%, dplyr::vars(), and tidyselect::one_of(), but these re-exports will be removed in a future release. Packages relying on them should import them directly from magrittr, dplyr, or tidyselect. (@olivroy, #2150)

Minor improvements and bug fixes

• Fixed LaTeX and RTF output for unformatted Date columns, which now show calendar dates instead of day counts since the Unix epoch (#2177). (@LeonidasZhak, #2180)
• Rows in LaTeX output tables no longer overlap when cell text contains line breaks (#2178). (#2179)
• Fixed cols_merge() with <</>> patterns producing corrupted output when data values contain < or > characters, particularly in LaTeX output (#2153). (#2156)
• Fixed gt_split() failing on grouped data frames by filtering stale row group metadata after subsetting rows (#2089). (#2157)
• Fixed md() in a column label causing the column to expand to full page width (\linewidth) in LaTeX/PDF output when no explicit column width is set (#2124). (#2162)
• Fixed text_transform() passing HTML-escaped text (e.g., &) to the user-supplied function instead of the original display text; functions like stringr::str_to_title() now receive and transform plain text as expected (#2033). (#2163)
• Fixed text_replace() failing to match patterns containing LaTeX special characters (e.g., underscores) in LaTeX/PDF output. The same plain-text pattern now works consistently in both HTML and LaTeX (#1592). (#2165)
• Styles applied with tab_style() to cells_column_spanners() are no longer dropped when tab_style() is called before tab_spanner() (#1438). (#2174)
• The headers attributes on <td> elements in HTML output tables now match the id attributes of their column headings when column names contain spaces, improving accessibility (#2085). (#2173)
• The vertical alignment of the row group column (with row_group_as_column = TRUE) can now be set with tab_style() through body cell styles. (#2176)
• Fixed cell misalignment when using summary_rows(side = "top") with row_group.as_column = TRUE and no stub column (#1561). (#2175)
• Styling can now be applied to summary rows in LaTeX output tables without error (#2117). (@thebioengineer, #2123)
• Fixed multi-column stub rowspans incorrectly crossing row-group boundaries when adjacent groups share the same stub value, which caused group labels to appear in the wrong rows (#2121). (#2161)
• Fixed grand summary rows rendering incorrectly in HTML output tables with a multi-column stub (#2164). (@ChidiebereNjoku, #2167)
• Fixed higher-level column spanners not displaying correctly when a multi-column stub is present (#2170). (@ysaidani, #2171)
• Fixed cells_stub() incorrectly resolving footnote row indices when a multi-column stub has repeated labels across non-contiguous groups (#2168). (@ysaidani, #2169)
• Improved RTF handling of column headers and spanners in tables with a multi-column stub (#2118). (@thebioengineer, #2145)
• Empty strings marked with md() are now handled correctly in Word output tables (#2119). (@thebioengineer, #2120)
• The keep_with_next parameter is now applied consistently in as_word() (#2149). (@shannonhaughton, #2151)
• Removed usage of dplyr::case_match(), which is deprecated as of dplyr 1.2.0. (@olivroy, #2125)
• Fixed several typos in the documentation. (@jeis4wpi, #2152)