Responsive email is HTML email designed to remain readable and actionable as the available viewport changes, especially between desktop and mobile clients. It often combines fluid dimensions, scalable images, stacking behavior, and media-query enhancements. The important word is enhancements: not every email client applies every responsive CSS rule, so the message needs a usable baseline before the media query runs. Gmail documents support for standard media queries, while broader compatibility data still shows client-specific differences and partial support across the email ecosystem.
Responsive email- What is responsive email? Build a usable baseline, then enhance it for the viewport
- The 3 layers of responsive email
- 1. Fluid baseline
- 2. Media-query enhancement
- 3. Interaction and accessibility
- Fluid is not the same as responsive
- Start with the narrow state mentally, even if you author desktop-first
- Stacking: preserve reading order
- Images: scale without making the message depend on cropping
- Buttons: width and hierarchy matter more than decorative precision
- Hybrid techniques can help when media-query support is uneven
- Responsive design and dark mode are separate axes
- Worked example
- What passes and what does not
- Common mistakes
- Questions we get asked
- OnVoard's take
What is responsive email? Build a usable baseline, then enhance it for the viewport
Responsive email is therefore not "make the desktop design smaller." It is the discipline of deciding what must reflow. It also decides what may simplify and what remains usable when a client ignores part of the responsive layer.
The 3 layers of responsive email
A useful mental model has 3 layers.
Fluid baseline first, media-query enhancement second
- Fluid baselineShrinkable containers, scalable images, wrapping text.
- Media-query enhancementStacking, spacing and alignment change at a breakpoint.
- Interaction and accessibilityTap targets and reading order, checked in both states.
1. Fluid baseline
The base layout should already tolerate a range of widths. Common techniques include:
- containers that can shrink rather than relying on a fixed desktop width
- images constrained to their container
- text that can wrap naturally
- spacing that does not depend on a precise screen width
- buttons that remain usable when text wraps
This baseline matters because it is what survives when a media query is unsupported or stripped.
2. Media-query enhancement
A media query can change layout when the viewport reaches a threshold. Examples include:
- stacking 2 columns vertically
- increasing button width
- adjusting type size or spacing
- hiding a genuinely nonessential decorative element
- changing alignment from horizontal to centered
Gmail's CSS documentation includes standard media-query support, but email-client compatibility should still be tested rather than inferred from web-browser behavior.
3. Interaction and accessibility
A layout that technically fits the screen can still be poor on mobile. The CTA may be tiny, links crowded, text unreadably small, or important content visually reordered in a confusing way. Responsive design is about use, not merely width.
WCAG 2.2's target-size guidance provides a useful accessibility reference point: targets should generally be at least 24 by 24 CSS pixels, subject to stated exceptions. Email clients and inbox contexts are not identical to websites, but the principle is valuable: do not make a critical mobile action depend on precision tapping.
Fluid is not the same as responsive
A fluid email changes size continuously with its container. A responsive email can also change structure at defined conditions. Consider a product card with image on the left and copy on the right:
- at 640 pixels, a 2-column layout may be comfortable
- as the container narrows, fluid widths can reduce both columns
- at a chosen breakpoint, a media query can stack image above copy
The fluid behavior reduces pressure before the breakpoint. The media query changes the information layout when side-by-side content is no longer useful. That combination preserves a usable fallback when the client ignores the breakpoint rule.
Start with the narrow state mentally, even if you author desktop-first
Mobile-first email thinking does not require that every line of CSS literally starts from mobile. It means the design has answered the narrow-screen constraints early:
- What is the primary action?
- Which content should appear first?
- Can the product name wrap to 3 lines?
- What happens to a long localized CTA?
- Can a price and discount fit without shrinking to unreadable text?
- Does an image crop hide the product when it becomes narrow?
If these questions are solved only after a desktop layout is approved, the mobile version often becomes a compressed afterthought.
Stacking: preserve reading order
2-column layouts are common in ecommerce email, but the stacking order matters. A desktop row such as: image | product name + price + CTA usually becomes: image → product name → price → CTA on mobile. That is straightforward. Alternating editorial layouts are harder. If desktop rows alternate image-left/text-right and text-left/image-right, a naive source order can produce a confusing mobile sequence. Copy may appear before the wrong image, and the visual rhythm may break.
The solution is not merely CSS. It begins with source order and component semantics. Build the HTML so the linear reading order remains sensible before applying visual rearrangement.
Images: scale without making the message depend on cropping
A common baseline for raster images is to allow the image to shrink with its container while preventing it from exceeding its intrinsic or intended width. The exact CSS varies by component and client, but the principle is stable. Also plan for:
- high-density screens
- blocked images
- text embedded inside imagery becoming unreadably small
- aspect-ratio changes if the template uses crops
- file size on mobile networks
An image can resize perfectly and still fail as responsive content if all the offer text is baked into a graphic that becomes too small to read.
Buttons: width and hierarchy matter more than decorative precision
A mobile CTA should remain easy to identify and tap. Depending on the component, that might mean a full-width button or a generously padded inline-block button. Do not rely on a tiny text link for the primary action simply because it fits the desktop design. The fallback should remain a real link. Decorative effects such as rounded corners or shadows are secondary.
Hybrid techniques can help when media-query support is uneven
Some email developers use so-called hybrid or spongy techniques, where percentage-based tables, max-width constraints, and inline-block behavior create a layout that adapts even before a media query. These patterns can be valuable for specific compatibility targets.
But a technique is not automatically good because it is clever. Prefer a component that your team can understand, test, and maintain. The purpose of hybrid behavior is to protect the fallback, not to accumulate obscure markup.
Responsive design and dark mode are separate axes
A mobile email can render in light or dark mode. A desktop email can also render in either. Do not treat "mobile" as a proxy for dark mode or vice versa.
An audience-based test matrix samples combinations that matter to your audience rather than testing every possible permutation. For example:
- Gmail mobile, light and dark if the design is dark-sensitive
- Apple Mail mobile
- Outlook mobile
- representative desktop/web clients
- classic Outlook for components known to have legacy rendering constraints
Worked example
Suppose a campaign contains 2 product cards side-by-side inside a 600-pixel content area.
- Each card has:
- a 260-pixel image
- product name
- current price
- short description
- CTA
- A fragile approach hard-codes the 2 cards at 300 pixels each and assumes a media query will always stack them. If the media query is ignored on a narrow client, the row may overflow or force tiny scaling
- A stronger version works in layers:
- Baseline: each card cell can shrink, images use a fluid maximum width, text can wrap, and the total structure does not rely on fixed child widths that exceed the viewport
Enhancement: below the chosen breakpoint, the card cells become block-like/stacked, image width increases relative to the viewport, spacing changes, and CTA width grows. Fallback test: dizable the media query. If the 2 cards remain legible enough to understand and act on, the baseline is doing its job.
What passes and what does not
- When a layout feels cramped, the wrong first move is often to reduce the font size. A better sequence is:
- remove unnecessary horizontal competition
- allow content to stack
- reduce nonessential decoration
- adjust spacing
- then tune typography within a readable range
- Line length also matters. A wide desktop email should not force paragraphs to span the full container, while a mobile layout should avoid side padding so large that it leaves a narrow sliver for text
Common mistakes
- If the layout is unusable without the breakpoint, the fallback is too fragile
- Responsive design should change information layout when necessary, not just reduce dimensions
display:nonecan be useful for decorative material, but hiding meaningful price, terms, or CTA context creates content parity problems- This can force horizontal scrolling or unexpected clipping
- Visual rearrangement cannot always rescue a confusing linear reading order
- Email CSS support is client-specific. Test delivered HTML in representative inboxes
Questions we get asked
Does responsive email require media queries?
Not necessarily. Fluid layouts can adapt without them, and hybrid techniques can provide useful fallback behavior. Media queries are powerful for structural changes such as stacking, but they should not be the only thing keeping the message usable.
What width should an email be?
There is no universal magic width. Many templates use a constrained desktop content width because it is readable and predictable, then allow the layout to adapt on smaller viewports. The important decision is how each component behaves as space changes.
Should every CTA become full width on mobile?
No. Full width can be useful for a dominant action, but it is a design choice, not a rule. The CTA needs sufficient size, contrast, and separation from competing targets.
Can responsive email be pixel-identical across clients?
That should not be the objective. Preserve reading order, meaning, and actions first. Accept benign visual differences where client capabilities vary.
OnVoard's take
A responsive email should fail gracefully before it succeeds beautifully. Build a fluid, understandable baseline; use media queries to improve structure; and test the final sent HTML in the clients that matter. The breakpoint is an enhancement mechanism, not a rescue mechanism.
Every app on every plan. Connect your store and switch on the flows in an evening.