theme_brand_gt: Create a gt table theme using brand colors

In brand.yml: Unified Branding with a Simple YAML File

Create a gt table theme using brand colors

Description

Apply brand colors to a gt table.

Usage

theme_brand_gt(table, brand = NULL, background = NULL, foreground = NULL)

Arguments

table	A gt table object to theme.
brand	One of: NULL (default): Automatically detect and read a _brand.yml file A path to a brand.yml file or directory containing _brand.yml A brand object (as returned by read_brand_yml() or as_brand_yml()) FALSE: Don't use a brand file; explicit colors must be provided
background	The background color, defaults to brand.color.background. If provided directly, this value can be a valid R color or the name of a color in brand.color or brand.color.palette.
foreground	The foreground color, defaults to brand.color.foreground. If provided directly, this value can be a valid R color or the name of a color in brand.color or brand.color.palette.

Value

Returns a themed gt table object.

See Also

Other branded theming functions: theme_brand_flextable(), theme_brand_ggplot2(), theme_brand_plotly(), theme_brand_thematic()

Examples

brand <- as_brand_yml('
color:
  palette:
    black: "#1A1A1A"
    white: "#F9F9F9"
    orange: "#FF6F20"
  foreground: black
  background: white
  primary: orange')

library(gt)
theme_brand_gt(
  gt(head(palmerpenguins::penguins)),
  brand
)


brand <- as_brand_yml('
color:
  palette:
    black: "#1A1A1A"
    white: "#F9F9F9"
    orange: "#FF6F20"
  foreground: black
  background: white
  primary: orange')

library(gt)
theme_brand_gt(
  gt(head(mtcars)),
  brand
)

brand.yml documentation built on Nov. 6, 2025, 5:06 p.m.