gt_group: Create a 'gt_group' container for holding multiple *gt* table...

View source: R/gt_group.R

gt_groupR Documentation

Create a gt_group container for holding multiple gt table objects


The gt_group() function creates a container for storage of multiple gt tables. This type of object allows for flexibility in printing multiple tables in different output formats. For example, if printing multiple tables in a paginated output environment (e.g., RTF, Word, etc.), each gt table can be printed independently and table separation (usually a page break) occurs between each of those.


gt_group(..., .list = list2(...), .use_grp_opts = FALSE)



One or more gt table data objects

⁠obj:<gt_tbl>⁠ // (optional)

One or more gt table (gt_tbl) objects, typically generated via the gt() function.


Alternative to ...

⁠<list of multiple expressions>⁠ // (or, use ...)

Allows for the use of a list as an input alternative to ....


Apply options to all contained tables?

⁠scalar<logical>⁠ // default: FALSE

Should options specified in the gt_group object be applied to all contained gt tables? By default this is FALSE.


An object of class gt_group.

Function ID


Function Introduced

v0.9.0 (Mar 31, 2023)

See Also

Other table group functions: grp_add(), grp_clone(), grp_options(), grp_pull(), grp_replace(), grp_rm(), gt_split()

gt documentation built on June 22, 2024, 11:11 a.m.