Email Design System
When to Use This Skill
Use this skill when you need to:
- Create a set of branded email templates for different use cases
- Standardize email design across marketing, transactional, and internal communications
- Define responsive email design rules for mobile and desktop
- Brief a developer or email platform on template requirements
DO NOT use this skill for writing email copy, email marketing strategy, or email deliverability optimization. This is for visual and structural email template design.
Core Principle
EMAIL DESIGN MUST WORK ON THE WORST-CASE SCENARIO — A 5-YEAR-OLD PHONE, OUTLOOK 2016, AND DARK MODE SIMULTANEOUSLY. DESIGN FOR CONSTRAINTS, NOT IDEALS.
Phase 1: Brief
Required Inputs
| Input |
What to Ask |
Default |
| Email types |
"What types of emails do you send? (newsletter, promotional, transactional, onboarding, announcement)" |
Newsletter and transactional |
| Platform |
"What email tool? (Mailchimp, ConvertKit, Klaviyo, SendGrid, custom)" |
Mailchimp |
| Brand guidelines |
"Brand colors, fonts, and logo?" |
Must be provided |
| Current issues |
"What is wrong with your current emails? (inconsistent, ugly on mobile, low clicks)" |
Inconsistent design |
| Audience |
"Who receives these emails? (customers, subscribers, internal team)" |
Customers and subscribers |
| Frequency |
"How often do you send each type?" |
Weekly newsletter, daily transactional |
GATE: Confirm brief before proceeding.
Phase 2: Design
Email Template System Components
- Global header — logo placement, navigation links, preheader text zone
- Global footer — social links, unsubscribe, physical address, legal text
- Content modules — reusable blocks (hero image, text block, CTA button, image + text, testimonial, divider)
- Button styles — primary CTA, secondary CTA, text link
- Typography — email-safe fonts, size hierarchy, line height
- Color application — background, text, CTA, accent usage rules
- Image guidelines — dimensions, alt text requirements, file size limits
Template Types
| Type |
Purpose |
Key Elements |
| Newsletter |
Regular content delivery |
Hero, 2-3 content blocks, CTA |
| Promotional |
Sale or offer announcement |
Hero image, offer details, urgency CTA |
| Transactional |
Order confirmation, receipts |
Clean layout, order details, next steps |
| Onboarding |
Welcome sequence |
Personal greeting, single action CTA |
| Announcement |
Product launch, company news |
Bold headline, concise body, CTA |
GATE: Present the system design and confirm template types needed.
Phase 3: Build
Deliverables
1. Email Design System Document
- Component library with specifications for each module
- Color and typography standards for email specifically
- Responsive breakpoints and mobile rules
- Dark mode considerations and fallbacks
2. Template Specifications (per type)
- Layout wireframe with module arrangement
- Content zones with character limits
- Image dimensions and alt text requirements
- CTA button specifications (size, color, padding, border radius)
3. Technical Constraints Guide
- Email-safe font stack (fallbacks for every font)
- Maximum email width: 600px
- Image guidelines: max 200KB per image, always include alt text
- Button: minimum 44x44px tap target on mobile
- Avoid: CSS grid, custom fonts without fallbacks, video embeds
4. QA Checklist
Phase 4: Polish
Implementation Guide
- How to build each template in the chosen email platform
- Module reuse instructions for the team
- Brand-approved image library or resource links
Governance
- Who can modify templates (role-based access)
- How to request a new template type
- Quarterly review to retire unused templates and add new ones
Example 1: SaaS Weekly Newsletter
Structure: Logo header → Hero image with headline → 3 content blocks (image + text) → CTA button → Social footer. Width: 600px. Single column on mobile.
Example 2: E-commerce Promotional Email
Structure: Logo header → Full-width hero with offer overlay → Product grid (2x2) → Countdown timer zone → CTA button → Footer. Dynamic product blocks from catalog.
Anti-Patterns
- Custom fonts without fallbacks — if the custom font does not load (common in Outlook), text displays in Times New Roman. Always declare fallbacks.
- Designing desktop-first — 60%+ of email opens are on mobile. Design mobile-first, enhance for desktop.
- Giant images with no alt text — when images are blocked (default in many clients), the email is blank. Alt text is not optional.
- Tiny CTA buttons — a 30px button on mobile is untappable. Minimum 44x44px touch target.
- Ignoring dark mode — transparent PNGs and black text on white backgrounds invert poorly. Test dark mode explicitly.
Recovery
- Email client rendering issues: Simplify the design. Tables-based layout is ugly but universally supported. Progressive enhancement on top.
- No developer available: Use the email platform's drag-and-drop builder with brand colors and fonts configured as defaults.
- Emails look different on every device: Accept that pixel-perfect is impossible in email. Aim for "consistently good" not "identical everywhere."
- Team sends off-brand emails: Lock down templates in the platform. Restrict editing to content zones only, not design elements.
1---2name: email-design-system3description: "Designs email template systems with header/footer standards, button styles, image guidelines, responsive rules, and type-specific layouts. Use when standardizing email communications."4allowed-tools: Read Write Glob5metadata:6 source: https://skillmd.com/skills/reaperinvest/email-design-system7 author: matthewhitcham8 version: "1.0"9---1011# Email Design System1213## When to Use This Skill1415Use this skill when you need to:16- Create a set of branded email templates for different use cases17- Standardize email design across marketing, transactional, and internal communications18- Define responsive email design rules for mobile and desktop19- Brief a developer or email platform on template requirements2021**DO NOT** use this skill for writing email copy, email marketing strategy, or email deliverability optimization. This is for visual and structural email template design.2223---2425## Core Principle2627EMAIL DESIGN MUST WORK ON THE WORST-CASE SCENARIO — A 5-YEAR-OLD PHONE, OUTLOOK 2016, AND DARK MODE SIMULTANEOUSLY. DESIGN FOR CONSTRAINTS, NOT IDEALS.2829---3031## Phase 1: Brief3233### Required Inputs3435| Input | What to Ask | Default |36|-------|------------|---------|37| **Email types** | "What types of emails do you send? (newsletter, promotional, transactional, onboarding, announcement)" | Newsletter and transactional |38| **Platform** | "What email tool? (Mailchimp, ConvertKit, Klaviyo, SendGrid, custom)" | Mailchimp |39| **Brand guidelines** | "Brand colors, fonts, and logo?" | Must be provided |40| **Current issues** | "What is wrong with your current emails? (inconsistent, ugly on mobile, low clicks)" | Inconsistent design |41| **Audience** | "Who receives these emails? (customers, subscribers, internal team)" | Customers and subscribers |42| **Frequency** | "How often do you send each type?" | Weekly newsletter, daily transactional |4344**GATE: Confirm brief before proceeding.**4546---4748## Phase 2: Design4950### Email Template System Components51521. **Global header** — logo placement, navigation links, preheader text zone532. **Global footer** — social links, unsubscribe, physical address, legal text543. **Content modules** — reusable blocks (hero image, text block, CTA button, image + text, testimonial, divider)554. **Button styles** — primary CTA, secondary CTA, text link565. **Typography** — email-safe fonts, size hierarchy, line height576. **Color application** — background, text, CTA, accent usage rules587. **Image guidelines** — dimensions, alt text requirements, file size limits5960### Template Types6162| Type | Purpose | Key Elements |63|------|---------|-------------|64| Newsletter | Regular content delivery | Hero, 2-3 content blocks, CTA |65| Promotional | Sale or offer announcement | Hero image, offer details, urgency CTA |66| Transactional | Order confirmation, receipts | Clean layout, order details, next steps |67| Onboarding | Welcome sequence | Personal greeting, single action CTA |68| Announcement | Product launch, company news | Bold headline, concise body, CTA |6970**GATE: Present the system design and confirm template types needed.**7172---7374## Phase 3: Build7576### Deliverables7778**1. Email Design System Document**79- Component library with specifications for each module80- Color and typography standards for email specifically81- Responsive breakpoints and mobile rules82- Dark mode considerations and fallbacks8384**2. Template Specifications (per type)**85- Layout wireframe with module arrangement86- Content zones with character limits87- Image dimensions and alt text requirements88- CTA button specifications (size, color, padding, border radius)8990**3. Technical Constraints Guide**91- Email-safe font stack (fallbacks for every font)92- Maximum email width: 600px93- Image guidelines: max 200KB per image, always include alt text94- Button: minimum 44x44px tap target on mobile95- Avoid: CSS grid, custom fonts without fallbacks, video embeds9697**4. QA Checklist**98- [ ] Renders correctly in Gmail, Apple Mail, Outlook99- [ ] Mobile responsive at 375px width100- [ ] Dark mode tested and readable101- [ ] All images have alt text102- [ ] Links work and track correctly103- [ ] Unsubscribe link functional104- [ ] Preheader text displays correctly105- [ ] Load time under 3 seconds106107---108109## Phase 4: Polish110111### Implementation Guide112113- How to build each template in the chosen email platform114- Module reuse instructions for the team115- Brand-approved image library or resource links116117### Governance118119- Who can modify templates (role-based access)120- How to request a new template type121- Quarterly review to retire unused templates and add new ones122123---124125## Example 1: SaaS Weekly Newsletter126127**Structure:** Logo header → Hero image with headline → 3 content blocks (image + text) → CTA button → Social footer. Width: 600px. Single column on mobile.128129## Example 2: E-commerce Promotional Email130131**Structure:** Logo header → Full-width hero with offer overlay → Product grid (2x2) → Countdown timer zone → CTA button → Footer. Dynamic product blocks from catalog.132133---134135## Anti-Patterns136137- **Custom fonts without fallbacks** — if the custom font does not load (common in Outlook), text displays in Times New Roman. Always declare fallbacks.138- **Designing desktop-first** — 60%+ of email opens are on mobile. Design mobile-first, enhance for desktop.139- **Giant images with no alt text** — when images are blocked (default in many clients), the email is blank. Alt text is not optional.140- **Tiny CTA buttons** — a 30px button on mobile is untappable. Minimum 44x44px touch target.141- **Ignoring dark mode** — transparent PNGs and black text on white backgrounds invert poorly. Test dark mode explicitly.142143---144145## Recovery146147- **Email client rendering issues:** Simplify the design. Tables-based layout is ugly but universally supported. Progressive enhancement on top.148- **No developer available:** Use the email platform's drag-and-drop builder with brand colors and fonts configured as defaults.149- **Emails look different on every device:** Accept that pixel-perfect is impossible in email. Aim for "consistently good" not "identical everywhere."150- **Team sends off-brand emails:** Lock down templates in the platform. Restrict editing to content zones only, not design elements.