The cols_unhide() function allows us to take one or more hidden columns (usually made so via the cols_hide() function) and make them visible in the final output table. This may be important in cases where the user obtains a gt_tbl object with hidden columns and there is motivation to reveal one or more of those.

cols_unhide(data, columns)



A table object that is created using the gt() function.


The column names to unhide from the output display table. Values provided that do not correspond to column names will be disregarded.


An object of class gt_tbl.


The hiding and unhiding of columns is internally a rendering directive, so, all columns that are 'hidden' are still accessible and useful in any expression provided to a rows argument. The cols_unhide() function quietly changes the visible state of a column (much like the cols_hide() function) and doesn't yield warnings or messages when changing the state of already-visible columns.


Function ID


See also


# Use `countrypops` to create a gt table; # Hide the columns `country_code_2` and # `country_code_3` tab_1 <- countrypops %>% dplyr::filter(country_name == "Mongolia") %>% tail(5) %>% gt() %>% cols_hide( columns = c( country_code_2, country_code_3 ) ) # If the `tab_1` object is provided without # the code or source data to regenerate it, and, # the user wants to reveal otherwise hidden # columns then the `cols_unhide()` function # becomes useful tab_2 <- tab_1 %>% cols_unhide(columns = country_code_2)