Image Requirements in Customer.io

Customer.io partner logo

Table of Contents

Summarize this documentation using AI

This banner was added using fs-inject

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Overview

Image requirements in Customer.io matter most when you are trying to turn product interest into revenue, because slow or broken images kill clickthrough on browse, cart, and post-purchase emails. Clean image specs keep your hero product, lifestyle shots, and offer modules loading fast across Gmail, Apple Mail, and mobile clients, while staying sharp on retina screens.

If you want help standardizing image specs across your templates and journeys, Propel can help you operationalize a consistent creative system inside Customer.io, so launches and promos ship faster and convert better, book a strategy call.

How It Works

Image requirements in Customer.io come down to how your email is rendered by inbox providers, not what looks good in a design file. You upload or reference images (hosted files) and place them into your email layout, then the recipient’s email client decides whether to download images, how to scale them, and when to block them by default.

In practice, your job is to design for three realities: images may be blocked, mobile screens dominate, and inboxes punish heavy emails. When we build D2C programs in Customer.io, we treat images as conversion support, not the only way the message makes sense. That means every key offer and product value prop must still work with images off.

Step-by-Step Setup

Image requirements in Customer.io are easiest to enforce when you treat them like a template system, not a one-off per campaign.

  1. Standardize core modules and sizes. Pick a single email width (commonly 600px) and define image slots for hero, product grid, and secondary banners (for example: hero 600px wide, 2-up products 300px wide each, 3-up products 200px wide each).
  2. Export images at 2x for retina, then display at 1x. Export a 1200px-wide hero, but set it to display at 600px in the email, so it stays crisp without relying on the inbox to upscale.
  3. Compress before upload. Keep file sizes tight (especially for multi-product emails). Aim for “fast enough on LTE” rather than “perfect in Figma.”
  4. Use the right format per use case. JPEG for photography and lifestyle, PNG only when you need transparency or sharp UI-like edges, and avoid overly heavy assets.
  5. Always add alt text that sells. Write alt text like a micro headline (product name, key benefit, offer), so the email still converts when images are blocked.
  6. Set explicit width and height where possible. This reduces layout shift while images load, which is a real conversion killer on mobile.
  7. Test in real inboxes. Send tests to Gmail (web and app), Apple Mail, and Outlook if your list skews corporate. Confirm scaling, cropping, and whether your CTA is still obvious with images off.

When Should You Use This Feature

Image requirements in Customer.io become a lever for revenue when your email performance depends on product visuals, offer clarity, and fast load times.

  • Abandoned cart recovery: Cart emails live or die on the product image and price context. Tight specs keep the cart item image crisp, with alt text that restates the product and urgency if images are blocked.
  • Product discovery journeys: If you send browse-based recommendations, consistent aspect ratios prevent messy grids and keep “tap targets” clean on mobile.
  • Launch and promo broadcasts: Heavy creative plus multiple modules can bloat the email. Compression and standardized sizes protect deliverability and keep the primary CTA visible quickly.
  • Post-purchase engagement: How-to images, care guides, and UGC modules need to load reliably. This is where “nice-to-have” imagery becomes a driver of repeat purchase.

Operational Considerations

Image requirements in Customer.io affect more than design, they influence segmentation, data flow, and how quickly your team can ship campaigns.

  • Dynamic content and product feeds: If you insert product images from a catalog or recommendations tool, enforce consistent aspect ratios upstream. Otherwise your grid will look broken even if your template is perfect.
  • Creative versioning: Build a small library of reusable modules (hero, 2-up, 3-up, banner, UGC) so your team is not reinventing image sizes for every send.
  • Deliverability and weight: Overly large images can slow load and increase spam complaints because the email “feels” broken. In retention programs we’ve implemented for D2C brands, trimming image weight is often the fastest win for clickthrough on mobile-heavy lists.
  • Accessibility: Alt text is not optional. Treat it like a second headline, especially for promos where the discount is baked into the image.

Implementation Checklist

Image requirements in Customer.io are easiest to maintain when you run the same pre-flight check before every launch.

  • Define standard email width and image slot widths (hero, grid, banners).
  • Export at 2x resolution, display at 1x size for retina clarity.
  • Compress images and cap file size targets for each module type.
  • Use JPEG for photos, PNG only when needed.
  • Add benefit-driven alt text for every image.
  • Set explicit dimensions to prevent layout shift.
  • Test with images on and off in Gmail and Apple Mail.
  • Confirm CTAs and offer text still read clearly without images.

Expert Implementation Tips

Image requirements in Customer.io become a competitive advantage when you pair them with a repeatable creative operating system.

  • Write alt text like a conversion line. Example for a cart item image: “The Everyday Hoodie, Black, size M. Still in your cart. Free shipping today.”
  • Keep promo text out of the image when possible. Inbox clients can block images, and spam filters can punish image-heavy emails with minimal text. Put the discount and deadline in HTML text, then use the image to support the vibe.
  • Design for thumb speed. On mobile, the first screen should load fast and communicate product, offer, and CTA without waiting for a large hero to download.
  • Standardize aspect ratios for recommendation blocks. If your “recommended for you” section pulls from multiple collections, force a consistent crop upstream so the grid does not jump between tall and wide images.

Common Mistakes to Avoid

Image requirements in Customer.io get teams into trouble when creative choices ignore inbox reality.

  • Using a single giant hero as the whole message. If images are blocked, the email becomes blank and your cart recovery loses money.
  • Skipping compression because the image “looks fine.” It might look fine on Wi-Fi, but it can load slowly on mobile and suppress clicks.
  • Inconsistent product image ratios. This breaks grids, reduces perceived quality, and makes recommendation emails feel chaotic.
  • Baking the offer into the image only. If the discount is not readable as text, you are depending on image downloads for conversion.
  • No testing across inboxes. A layout that works in Apple Mail can render poorly in Gmail app, especially around scaling and padding.

Summary

Use image requirements in Customer.io when your emails rely on product visuals to drive clicks and revenue. Tight specs, compression, and alt text protect conversion in cart recovery, discovery, and post-purchase flows inside Customer.io.

Implement with Propel

Propel helps D2C teams standardize creative modules and enforce image specs across Customer.io journeys so campaigns ship faster and perform more consistently. book a strategy call.

Contact us

Get in touch

Our friendly team is always here to chat.

Here’s what we’ll dig into:

Where your lifecycle flows are underperforming and the revenue you’re missing

How AI-driven personalisation can move the needle on retention and LTV

Quick wins your team can action this quarter

Whether Propel AI is the right fit for your brand, stage, and stack