DESIGN.md · Analysis

WhatsApp for Business

whatsappbusiness.com · 19 Aug 2026 · 47 colors · WhatsApp Sans Var, Arial, sans-serif

WhatsApp for Business

A conversational commerce platform serving 2+ billion users globally, enabling businesses to drive customer engagement, marketing, sales, and support through AI-powered messaging.

Colors

surface#ffffff
surface-dim#f5f5f5
surface-bright#ffffff
surface-container-lowest#fafafa
surface-container-low#f0f0f0
surface-container#eeeeee
surface-container-high#e8e8e8
surface-container-highest#dcdcdc
on-surface#1c1e21
on-surface-variant#65676b
inverse-surface#111b21
inverse-on-surface#ffffff
outline#8a8d91
outline-variant#c4d0d4
surface-tint#25d366
primary#25d366
on-primary#ffffff
primary-container#a8f3d4
on-primary-container#003d2e
inverse-primary#43cd66
secondary#0693e3
on-secondary#ffffff
secondary-container#cce5ff
on-secondary-container#001d3c
tertiary#ff6900
on-tertiary#ffffff
tertiary-container#ffd8b5
on-tertiary-container#331900
error#cf2e2e
on-error#ffffff
error-container#f9dedc
on-error-container#410e0b
primary-fixed#a8f3d4
primary-fixed-dim#7ce0b8
on-primary-fixed#002117
on-primary-fixed-variant#003d2e
secondary-fixed#cce5ff
secondary-fixed-dim#b0cce5
on-secondary-fixed#001d3c
on-secondary-fixed-variant#004a8f
tertiary-fixed#ffd8b5
tertiary-fixed-dim#ffb88f
on-tertiary-fixed#331900
on-tertiary-fixed-variant#663300
background#ffffff
on-background#1c1e21
surface-variant#e8e8e8

Typography

display
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 61px · fontWeight: 400 · lineHeight: 68px · letterSpacing: -0.02em
headline-lg
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 40px · fontWeight: 400 · lineHeight: 48px · letterSpacing: -0.01em
headline-md
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 28px · fontWeight: 400 · lineHeight: 36px · letterSpacing: 0em
title-lg
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 20px · fontWeight: 500 · lineHeight: 28px · letterSpacing: 0.01em
body-lg
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 18px · fontWeight: 400 · lineHeight: 28px · letterSpacing: 0em
body-md
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 16px · fontWeight: 400 · lineHeight: 24px · letterSpacing: 0.25px
label-md
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 14px · fontWeight: 500 · lineHeight: 20px · letterSpacing: 0.01em
label-sm
fontFamily: WhatsApp Sans Var, Arial, sans-serif · fontSize: 12px · fontWeight: 500 · lineHeight: 16px · letterSpacing: 0.04em

Design guidance

Overview

WhatsApp for Business is a conversational commerce platform that transforms customer interactions into business outcomes. Serving 2+ billion users globally, it enables enterprises to drive engagement, marketing, sales, and customer support through AI-powered messaging. The design aesthetic is "Accessible Minimalism with Conversational Warmth"—a clean, light-dominant interface anchored by WhatsApp's signature vibrant green (#25d366) accent, which signals trust, action, and the human connection at the heart of every conversation. The UI prioritizes clarity and directness: white backgrounds (rgb(255, 255, 255)), deep neutral text (rgb(28, 30, 33)), and generous whitespace create an environment where business messaging feels natural, not corporate. The brand voice is conversational yet professional: precise, empathetic, and action-oriented. Example: "Start conversations that matter—turn inquiries into orders, support into loyalty."

Colors

The color system centers on WhatsApp's iconic green (#25d366 / rgb(37, 211, 102)) as the primary accent—used exclusively on CTAs, active states, and brand-critical interactive elements. This green is not decorative; it signals actionable moments and brand recognition. The surface stack is light-first: white (#ffffff) as the dominant background, with a subtle gray hierarchy (surface-container: #eeeeee, surface-container-high: #e8e8e8) for secondary containers and cards. Dark neutrals (on-surface: #1c1e21, rgb(28, 30, 33)) provide text contrast at WCAG AAA levels. Secondary accent blue (#0693e3) supports data visualization and secondary CTAs; tertiary orange (#ff6900) highlights promotional or urgent messaging. The alert banner uses a deep forest green (#103928) background with white text to

Typography

The type system uses WhatsApp Sans Var exclusively, a custom variable font optimized for legibility across all screen sizes and weights. Display (61px, 400 weight, -0.02em tracking) anchors hero sections with calm authority; headline-lg (40px) and headline-md (28px) structure content hierarchy without visual noise. Body text (16px, 400 weight) is set at the platform's native rendering size, ensuring no forced scaling. Label weights (500) distinguish interactive elements (buttons, badges) from passive content. The type pairing communicates "modern yet approachable": no serifs, no decorative flourishes, just precision. On small labels over busy backgrounds (e.g., badge text on cards), apply text-rendering: optimizeLegibility and letter-spacing: 0.04em to maintain crispness at 12px.

Layout

The layout follows a 12-column fluid grid with a fixed max-width of 1299px, centered on the viewport. Container padding is 20px on mobile, scaling to 48px on desktop (via --wp--custom--site-outer-padding). Section separation uses lg spacing (40px) vertically and md spacing (24px) horizontally between content blocks. The hero section spans full-width with 80px vertical padding and 48px horizontal padding, creating a breathing room that emphasizes the primary message. Cards and content containers use md spacing (24px) internally. Whitespace is intentional: the design avoids cramping, allowing the eye to rest and focus on conversational elements (chat bubbles, message previews). The grid is responsive, collapsing to single-column on screens below 1299px with maintained spacing ratios.

Elevation & Depth

Depth is achieved through subtle shadows and surface color shifts, not dramatic layering. The base level (Level 1) is the white surface (#ffffff) with no shadow. Level 2 (cards, input fields) uses elevation.md: 0 4px 12px rgba(0, 0, 0, 0.08)—a soft, diffuse shadow that suggests a slight lift without visual weight. Level 3 (modals, expanded cards on hover) uses elevation.lg: 0 4px 24px rgba(0, 0, 0, 0.15)—a more pronounced shadow indicating modal prominence. The alert banner at the top of the page uses no shadow, relying instead on its dark background (#103928) and position to establish hierarc

Shapes

The shape philosophy is "Conversational Softness"—rounded corners signal approachability and reduce visual harshness, while maintaining enough definition to distinguish interactive elements. Buttons use full radius (9999px / border-radius: 48px on 48px-tall buttons), creating pill-shaped CTAs that feel inviting and clickable. Cards and containers use lg radius (16px), providing subtle rounding that softens edges without appearing cartoonish. Input fields use DEFAULT radius (8px), a middle ground that feels modern and controlled. The alert banner uses 0px radius (sharp edges) to signal its stru

Components

Action Elements Buttons are the primary interaction pattern. The primary button (button-primary) uses the brand green (#25d366) background, white text (rgb(255, 255, 255)), full radius (9999px), and padding of 12px 48px on a 48px height. Font weight is 500 (medium), size 16px. On hover (button-primary-hover), the background shifts to #1fb854 (a darker green) with a 200ms ease-in-out transition. The secondary button (button-secondary) inverts this: white/light gray background (#dcdcdc or surface-container-highest), dark text (#1c1e21), and a 1px outline-variant border (#c4d0d4). Both buttons use the same dimensions and radius for consistency.

Containers & Surfaces Cards (card) use white background (#ffffff), lg radius (16px), md padding (24px), and elevation.md shadow (0 4px 12px r

Do's and Don'ts

**Do**

  • Do use the primary green (#25d366) exclusively for CTAs, active states, and brand-critical moments—never for passive elements or backgrounds.
  • Do maintain whitespace generously: use lg spacing (40px) between major sections and md spacing (24px) between related content blocks to avoid cognitive overload.
  • Do apply full radius (9999px) to all buttons and interactive pills to signal approachability and conversational warmth.
  • Do use WhatsApp Sans Var at 16px body size with 400 weight for maximum legibility; never force smaller sizes without explicit UX justification.
  • Do layer shadows subtly: elevation.md for cards, elevation.lg for modals—never use harsh, dark shadows that feel heavy or corporate.

**Don't**

  • Don't use the primary green for backgrounds, borders, or decorative elements—reserve it for interactive moments only.
  • Don't apply sharp corners (0px radius) to buttons or cards; the brand relies on softness to feel conversational.
  • Don't mix font families; WhatsApp Sans Var is the sole typeface—system fonts or serif alternatives break brand coherence.
  • Don't exceed 3 levels of visual hierarchy in a single section; too many font sizes or colors fragment attention.
  • Don't use dark overlays or heavy shadows to create depth; the light surface stack and subtle elevation system are sufficient.