Email Theme

An Email Theme contains the global CSS stylesheet and typography rules applied to your transactional email communications. It standardises font families, container widths, color palettes, call-to-action (CTA) buttons, and element padding across all outgoing emails.

How it works

1. Create an email theme — define a unique name, description, and status for your design theme.
2. Customise CSS rules — write custom CSS inside the style field to style .container, .content, .field-table, .message-box, .cta-button-primary, and other template components.
3. Inject into emails — the platform compiles theme styles directly into your rendered Email Templates during transactional delivery.

Fields

Basic information

Styling settings

Code
body {
    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
    background-color: #f4f7f9;
    margin: 0;
    padding: 0;
    -webkit-font-smoothing: antialiased;
}
.container {
    max-width: 600px;
    margin: 40px auto;
    background-color: #ffffff;
    border-radius: 8px;
    overflow: hidden;
}
.content {
    padding: 40px;
    color: #333333;
    line-height: 1.6;
}
.field-table {
    width: 100%;
    border-collapse: collapse;
    margin: 24px 0;
}
.field-table tr {
    border-bottom: 1px solid #f0f0f0;
}
.field-label {
    width: 36%;
    padding: 10px 12px 10px 0;
    font-size: 13px;
    font-weight: 600;
    color: #888888;
    text-transform: uppercase;
    letter-spacing: 0.04em;
}
.field-value {
    padding: 10px 0;
    font-size: 15px;
    color: #333333;
}
.message-box {
    background-color: #f8f9fb;
    border-left: 3px solid rgb(124, 58, 237);
    border-radius: 4px;
    padding: 16px 20px;
    margin: 4px 0;
}
.cta-button-primary {
    margin-top: 30px;
    padding: 10px 20px;
    background-color: rgb(124, 58, 237);
    border-radius: 20px;
    color: #ffffff !important;
    text-decoration: none;
}

Real-world examples

🎨 Modern Brand Email Theme

Code
{
  "name": "Default Brand Theme",
  "description": "Standard corporate email theme with purple accent CTA buttons.",
  "style": "body { font-family: 'Inter', sans-serif; background-color: #f8fafc; } .container { max-width: 600px; margin: 30px auto; background: #ffffff; border-radius: 12px; } .cta-button-primary { background-color: #7c3aed; color: #ffffff; padding: 12px 24px; border-radius: 8px; font-weight: 600; }",
  "status": "live"
}

Access & permissions

Related resources

API reference

See the API Reference for full request/response schemas and interactive examples for:

• GET /schema/email_theme/record — list email themes
• POST /schema/email_theme/record — create an email theme
• GET /schema/email_theme/record/{id} — get an email theme by ID
• PATCH /schema/email_theme/record/{id} — update an email theme
• DELETE /schema/email_theme/record/{id} — delete an email theme