Skip to content

docs: update email layout docs with branding-aware buttons, dark mode, and plan availability#1499

Draft
samseely wants to merge 2 commits into
mainfrom
cursor/email-layout-docs-update-46e3
Draft

docs: update email layout docs with branding-aware buttons, dark mode, and plan availability#1499
samseely wants to merge 2 commits into
mainfrom
cursor/email-layout-docs-update-46e3

Conversation

@samseely

Copy link
Copy Markdown
Contributor

Description

This PR updates the email layout documentation to reflect recent product changes:

Email layouts page (/integrations/email/layouts)

  • Expanded the branding variables table to include all 8 variables with descriptions, including the new dark mode variants (dark_primary_color, dark_primary_color_contrast)
  • Added a new "Branding-aware buttons" section documenting:
    • Legacy .button class wiring to branding colors
    • Visual editor .block-button solid/outline behavior in light and dark mode
    • Explanation of why dark mode requires !important overrides (the visual editor renders button colors as static inline styles that don't change between light/dark)
    • CSS code snippet for branding-aware button styles

MJML support page (/integrations/email/mjml)

  • Added "Dark mode support in MJML layouts" section with MJML-specific code snippet
  • Added "Branding-aware buttons in MJML layouts" section documenting the same behavior as HTML layouts, with MJML styling code

Client previews page (/integrations/email/client-previews)

  • Removed the "Enterprise plan feature" callout
  • Added an "Availability" section explaining that client previews are now available on all paid plans (Starter and above)
  • Documented the disabled button behavior with tooltip on the free plan

Screenshots

Email layouts - Branding variables table:
Branding variables table showing all 8 variables

Email layouts - Branding-aware buttons section:
Branding-aware buttons documentation section

MJML - Dark mode and branding-aware buttons:
MJML dark mode and branding-aware buttons sections

Client previews - Updated availability:
Client previews page showing availability on all paid plans

To show artifacts inline, enable in settings.

Linear Issue: KNO-13880

Open in Web Open in Cursor 

…, and plan availability

- Email layouts page:
  - Expand branding variables table with dark_primary_color and dark_primary_color_contrast
  - Add branding-aware buttons section documenting legacy .button and visual editor .block-button behavior
  - Explain why dark mode requires !important overrides for button styles
  - Include CSS code snippet for branding-aware button styles

- MJML support page:
  - Add dark mode support section with MJML-specific code snippet
  - Add branding-aware buttons section with MJML styling code

- Client previews page:
  - Update plan availability from Enterprise-only to all paid plans (Starter+)
  - Remove Enterprise callout and add Availability section
  - Document disabled button behavior on free plan

Resolves: KNO-13880

Co-authored-by: Sam Seely <samseely@gmail.com>
@vercel

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jun 22, 2026 5:10pm

Request Review

Co-authored-by: Sam Seely <samseely@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants