Setting up product images in Shopify
Image specs, upload pipeline, alt text strategy, theme settings, and the common mistakes that tank PageSpeed scores. Plus how QuickStyle plugs into the Shopify image flow.
Shopify makes image management easier than most platforms but easier-than-most-platforms is still a category where most stores get it wrong. This guide covers the practical pipeline: what to upload, how to upload it, where it should appear, and what to fix on a store with image bloat.
Image specs Shopify actually uses
Shopify recommends specs and then automatically transforms uploaded images. The recommendations matter, the transforms more.
Source image specs (what you upload)
- Dimensions: 2048×2048px for primary product images. Larger if you want zoom support.
- Format: JPEG (best for photographs), PNG (for graphics with transparency), WebP (most efficient, supported in modern themes).
- File size: Under 20MB per image (Shopify’s hard cap is much higher, but anything above 20MB is wasted upload time).
- Color profile: sRGB. Don’t upload Adobe RGB or ProPhoto images — they’ll display oddly on customer browsers.
What Shopify serves to customers
Shopify generates multiple sizes from your upload and serves them via a built-in CDN. Theme code typically uses image_url: 'master' for hero shots and smaller variants for thumbnails. Image dimensions on customer browsers:
- PDP hero: 1024–2048px wide depending on viewport.
- Collection page thumbnails: 480–800px.
- Cart and search thumbnails: 100–250px.
Always upload the largest reasonable size. Shopify will downscale; it won’t upscale.
The 5-shot Shopify PDP
Shopify themes universally support 5+ images per product. Five is the magic number — enough to tell the story, not so many that customers stop clicking.
The five-shot sequence we recommend:
- Hero on neutral. Crisp, clean, well-lit on a near-white background. The first image is the one that drives click-through from collection pages.
- Lifestyle / context. Product in environment (worn, used, on a counter, in a bag). This sells the feeling.
- Detail crop. A close-up of the most important feature.
- Scale or fit reference. A hand, a body, a coin — something that lets the customer judge size.
- Variant or alternate angle. Especially important for apparel and shoes — back/side view that the hero doesn’t show.
Stores with all five shots convert 18–24% better than stores with only one or two on the same product (internal benchmark, ~3,000 SKUs).
Alt text: required, undervalued
Shopify lets you add alt text to every product image. Most stores leave it blank or fill it with the product title, both of which leave SEO and accessibility value on the table.
The alt text pattern that works:
[Product name] — [Distinguishing feature] — [Context or material]Examples:
Caldera Linen Dress — Boatneck silhouette — Photographed in natural daylight on cream backdropForge Brass Pendant — Hand-engraved geometric pattern — On 18" rolo chain
This is parsed by:
- Screen readers for accessibility.
- Search engines for image search rankings.
- Shopify’s own search for in-store product discovery.
Generic alt text loses on all three.
File naming before upload
Shopify uses the original filename for both URL slugs and (sometimes) alt-text fallback. The default IMG_2174.jpg is bad for both.
Rename your images with a hyphenated, descriptive pattern before uploading:
caldera-linen-dress-hero.jpg
caldera-linen-dress-lifestyle-cafe.jpg
caldera-linen-dress-detail-boatneck.jpgThis takes 3 seconds per image and pays compounding SEO returns. Bulk-rename tools (Apple Finder’s “Rename Items,” Windows’ rename multi-select) handle this in batches.
Theme settings that matter
Most Shopify themes have image settings tucked into Theme Settings. The two that matter most:
- Lazy load. Should be on. Default is on in modern themes.
- Image quality / compression. Some themes expose this; default to 85–90%. Lower settings ship faster but degrade visibly on retina displays.
The PageSpeed killers
The top three image issues that hurt Shopify store PageSpeed:
- Oversized hero images on the homepage. A 4MB hero on a 320px-wide mobile screen is a 4MB hero. Compress and size-cap.
- Thumbnails served at full size. A collection page rendering 24 product thumbnails at 2048px is downloading 50MB of images. Themes should request smaller variants.
- Carousel auto-play with all images preloaded. Carousels are themselves a performance hit; preloading every slide compounds it.
Fix these three and most stores will see a 15–30 point Lighthouse improvement.
Connecting QuickStyle to Shopify
If you’re using QuickStyle for renders, the integration paths:
The Shopify app is worth the 5-minute install if you’re going to render more than 10 SKUs. If you’re rendering 1–2 hero shots, manual download/upload is fine.
The “fixing an existing store” workflow
If you’ve inherited a Shopify store with image bloat, the audit:
- Run PageSpeed Insights on your top 5 PDPs. Note the “image opportunities” section.
- Spot-check 10 product images for source dimensions (right-click → save as → check file properties). Anything over 20MB is suspicious.
- Open your theme’s image settings and confirm lazy load is on, compression is at 85%+.
- Check alt text fill rate in Shopify admin (no native report, but you can spot-check 20 products).
- Identify the worst-offending product and fix it as a template for the rest.
Common findings: 40–60MB hero images, blank alt text on 80%+ of products, themes set to “max quality” everywhere. Each is a 30-minute fix.
The 30-minute audit script
If you’ve got a half hour and want to know whether your Shopify store has image problems:
- 5 min: PageSpeed check on homepage + 2 PDPs.
- 10 min: Inspect file sizes on 5 product hero images.
- 5 min: Check alt text on 10 random products.
- 5 min: Review theme image settings.
- 5 min: Make a punch list.
This is the same audit we run on customer stores during onboarding. 90% of the time, it surfaces 2–3 fixable issues that move PageSpeed scores by double-digit margins.