rm_header: Remove the table header

View source: R/tab_remove.R

rm_headerR Documentation

Remove the table header


We can remove the table header from a gt table quite easily with rm_header(). The table header is an optional table part (positioned above the column labels) that can be added through the tab_header().

This function for removal is useful if you have received a gt table (perhaps through an API that returns gt objects) but would prefer that the table not contain a header. This function is safe to use even if there is no header part in the input gt_tbl object.





The gt table data object

⁠obj:<gt_tbl>⁠ // required

This is the gt table object that is commonly created through use of the gt() function.


An object of class gt_tbl.


Let's use a subset of the gtcars dataset to create a gt table. A header part can be added with the tab_header() function; with that, we get a title and a subtitle for the table.

gt_tbl <-
  gtcars |>
  dplyr::select(mfr, model, msrp) |>
  dplyr::slice(1:5) |>
  gt() |>
    title = md("Data listing from **gtcars**"),
    subtitle = md("`gtcars` is an R dataset")

This image of a table was generated from the first code example in the `rm_header()` help file.

If you decide that you don't want the header in the gt_tbl object, it can be removed with the rm_header() function.

rm_header(data = gt_tbl)
This image of a table was generated from the second code example in the `rm_header()` help file.

Function ID


Function Introduced

v0.8.0 (November 16, 2022)

See Also

Other part removal functions: rm_caption(), rm_footnotes(), rm_source_notes(), rm_spanners(), rm_stubhead()

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