Email Theme

The email theme is your organization's default design system for all emails. It defines the baseline colors, fonts, and spacing that every new template...

The email theme is your organization's default design system for all emails. It defines the baseline colors, fonts, and spacing that every new template inherits — giving your emails a consistent look without configuring each one from scratch.

Accessing the theme

Open Settings > Email Theme to view and edit your theme settings.

Theme settings

Core design tokens

SettingWhat it controlsExample
Primary ColorButtons, links, and accent elements#2563EB (blue)
Background ColorThe outer background behind your email content#F3F4F6 (light gray)
Font FamilyThe default typeface for body textArial, Helvetica, sans-serif

Extended tokens

For more fine-grained control, you can also configure:

  • Heading Font Family — a different typeface for headings (h1, h2, h3)
  • Body Font Size — the default text size for paragraphs
  • Body Text Color — the default color for body text
  • Link Color — the color for hyperlinks
  • Border Radius — default corner rounding for buttons and containers
  • Spacing Unit — the base unit for padding and margins

Default block styles

The theme also includes default styles for specific block types:

  • Button defaults — background color, text color, border radius, and padding for all buttons
  • Heading defaults — font sizes and colors for h1, h2, and h3 headings
  • Block defaults — default properties for any of the 18 block types (text, image, button, divider, spacer, columns, social, container, hero, table, rawHtml, video, accordion, menu, carousel, list, progressBar, countdown). For example, set default padding for all text blocks, default border-radius for all containers, or default icon size for all social blocks.

These defaults apply automatically to new blocks. You can always override them on individual blocks within a template.

Block defaults work like a cascade: theme block defaults are merged into block content before rendering. Block-level values always take priority over theme defaults.

How the theme works with templates

The theme sets the starting point — every new template picks up your theme's colors, fonts, and styling. But templates can override any theme setting at the block level.

Think of it as a cascade:

  1. Theme defines organization-wide defaults
  2. Template can override theme values for a specific email
  3. Individual blocks can override template values for specific content

Set your theme early, before building templates. It's much easier to start with the right defaults than to go back and update every template later.

Practical examples

Consistent branding

Set your primary color to match your brand, choose your brand font, and pick a background color that works with your website. Every email your team creates will start with these settings.

Seasonal updates

During a holiday promotion, you might temporarily change your primary color from blue to red. All new templates will inherit the festive palette.

Changing the theme doesn't retroactively update existing templates. It only affects new templates and new blocks added to existing templates.

Next steps