Install Retouchable in ChatGPT Retouch your product photos from a ChatGPT chat. Install in ChatGPT
  1. Turn on Developer mode

    In ChatGPT, open Settings → Security and login and switch on Developer mode.

  2. Copy the address, open ChatGPT

    https://api.retouchable.ai/api/mcp

    Copy & open ChatGPT ↗
  3. Create the app

    On ChatGPT's Plugins page, select + and choose Create MCP App. Name it Retouchable, paste the address, set authentication to OAuth and create it.

  4. Sign in to Retouchable

    ChatGPT opens our sign-in. New to Retouchable? That starts your 14-day free trial, no card.

Then, in a chat, choose Retouchable under Developer mode and ask: “Grade the photos on my store” or “Put my product photo on white.”

Needs ChatGPT Plus, Pro, Business, Enterprise or Edu, on the web. Menus look different? OpenAI's steps

Shopify Product Media Limits, Formats and Sizes

What Shopify accepts for product images, video and 3D models, what it refuses, and how to stay clear of the limits when you upload a whole catalogue.

|Shopify product image requirements image optimization

Shopify's product media limits are generous enough that most merchants never think about them, until an upload fails with no useful message or a 3D model silently refuses to appear on the product page. An image can be up to 20 MB and 25 megapixels. A video can be up to 1 GB and 10 minutes long. A 3D model can be up to 500 MB. Each of those numbers comes with smaller rules that cause most of the trouble in practice.

This is a reference for those rules: which formats Shopify takes for each kind of media, the hard caps, the plan-level limits that apply across a whole store, and the filename and aspect-ratio quirks that trip up bulk uploads. Every figure comes from Shopify's own help center as of November 2026. Where Shopify doesn't publish a number, this guide says so rather than guessing.

One distinction runs through all of it. A limit is what Shopify will accept. A recommendation is what looks and loads best. A 24-megapixel PNG is inside the limits and still a poor choice for a product page. The limits come first below, then what to actually export.

Shopify product media limits at a glance

Shopify treats product media as three kinds of file: images, videos and 3D models. Each has its own formats and caps. YouTube and Vimeo links are a fourth option for video and skip the upload limits entirely, because the file never lives on Shopify.

MediaFormatsMax file sizeMax dimensions / length
ImagesJPEG, PNG, WebP, HEIC, GIF (product media also takes TIFF, BMP, SVG)20 MB5000 × 5000 px or 25 MP; aspect ratio between 100:1 and 1:100
VideoMP4, MOV, WebM1 GB10 minutes; up to 4096 × 2160 (4K); at least 100 px each side; up to 120 fps
3D modelsGLB, USDZ500 MBOptimized automatically above 15 MB
External videoYouTube or Vimeo URLNo Shopify limitOther video hosts are not supported

Two of Shopify's pages list image formats slightly differently. The product media page names PNG and JPEG first and also accepts TIFF, BMP, GIF, SVG, HEIC and WebP. The general file-upload table lists JPEG, PNG, WebP, HEIC and GIF. If you're uploading product photos, stick to JPEG, PNG or WebP and both lists apply to you.

Per-product count

Shopify's help pages don't publish a maximum number of media per product. Bulk-import tools report Shopify refusing uploads past 250 media on one product, with the error "Limit of 250 media per product reached". Few catalogues come near that, but variant-heavy products with a photo per colour and angle can.

Image limits: 20 MB, 25 megapixels, and what that really means

A file has to pass two independent caps. It must be under 20 MB, and it must be no more than 25 megapixels, which Shopify describes as up to 5000 × 5000 px. A file can fail either one while passing the other. This is the most common source of "my image won't upload" posts on the Shopify community forums, where a merchant checks the file size, sees 12 MB, and can't work out what's wrong.

The megapixel cap counts width times height, and compression doesn't change it. A 7000 × 4000 crop is 28 megapixels and is over the cap even when it's saved as a small, heavily compressed JPEG. If a camera file is anywhere near 25 MP, or has a long edge past 5000 px, resize it before upload rather than finding out which rule Shopify applies.

20 MBMax image file size
25 MPMax image resolution
2048 pxShopify's recommended square size
100:1Most extreme aspect ratio allowed

Files most likely to hit a cap:

  • Uncompressed PNGs from editing software. A 5000 × 5000 PNG of a detailed product on a textured background can pass 20 MB well before it reaches the pixel cap.
  • Medium-format and high-resolution camera files. Anything above 25 MP straight out of camera has to be resized before upload.
  • Stitched or extended images. Lifestyle banners built from several shots, or images padded out for a wide format, can pass 25 MP quickly.
  • Extreme crops. A tall strip for a belt or a thin banner can fall outside the 1:100 to 100:1 aspect ratio, though that's rare in a product gallery.

Shopify also keeps your original. The unoptimized file you uploaded can be downloaded again from Content › Files, which matters if you ever need to re-crop or re-edit and have lost the source.

What Shopify does to an image after you upload it

Uploading a file within the limits is not the end of its journey. Shopify's image service generates several sizes of every product image, such as a large version for the product page and smaller ones for collection grids. It also checks which formats the shopper's browser supports and serves the best one it can. Themes request those derivatives through the Shopify CDN, so the shopper almost never downloads the file you uploaded.

This has three practical consequences:

  • You don't need to upload WebP to get WebP delivery. Shopify picks the delivery format for each browser. Uploading a high-quality JPEG or PNG and letting the CDN convert it is a sound default. For the trade-offs between formats as files, see WebP vs JPEG vs PNG vs AVIF for e-commerce.
  • A bigger upload is not a sharper product page. The theme asks for the size its layout needs. Past a certain point, extra pixels only make the upload slower and the stored original larger.
  • Bad source pixels stay bad. Resizing and format conversion don't fix soft focus, colour casts or a dusty background. Whatever you retouch before upload is what every derivative inherits.
Keep the original in sRGB

Shopify doesn't publish a colour-profile requirement for images. Browsers assume sRGB, though, and a file in a wide-gamut profile can look dull or shifted once it's converted. Exporting product photos in sRGB is the safe choice.

Page weight is a separate question from what Shopify accepts. We cover export sizes and the theme-side causes of slow galleries in Shopify Image File Size and Page Speed.

Filenames that break Shopify's CDN

This is the least-known rule in Shopify's media documentation, and it can break images that are otherwise fine. The CDN reads part of an image URL as a request for a transformed version, so some filenames are taken as instructions instead of names.

Shopify advises against filenames that end in any of these words:

Avoid ending a filename inSafer alternative
linen-shirt-small.jpglinen-shirt-size-s.jpg
ceramic-mug-large.jpgceramic-mug-12oz-front.jpg
wallet-thumb.jpgwallet-detail-stitching.jpg
lamp-icon.pnglamp-brass-side.png
product_image_5x4.jpegproduct-image-5x4.jpeg

The full list of endings to avoid is pico, icon, thumb, testing, small, compact, medium, large and grande. Shopify also warns against an underscore directly before dimensions, as in the last row above. Use a hyphen.

Size names cause most of the trouble in practice. A clothing store that names files by variant (tee-black-small.jpg, tee-black-large.jpg) walks straight into the rule. Put the size somewhere other than the end, or use the size code instead of the word.

Filenames are also a small search signal, which makes them worth getting right for another reason. Our guide to Shopify image metadata: alt text, filenames and order covers how to name files so they work for search and for people.

Replacing a file keeps its format

When you replace an existing file in Content › Files, Shopify requires the new file to be the same format, so a JPEG can only be replaced by a JPEG. To change format, upload a new image and remove the old one.

Video and 3D model limits

Video and 3D have their own per-file caps, and they also count against store-wide limits, covered in the next section.

Video

Shopify accepts MP4, MOV and WebM, up to 1 GB and 10 minutes, and at least a quarter of a second long. Resolution can go up to 4K (4096 × 2160), with each side at least 100 px, at up to 120 frames per second. Whatever you upload, Shopify converts it and serves it as MP4 or adaptive HLS streaming. Shoppers see 480p, 720p or 1080p depending on their connection and the resolution you uploaded.

Shopify's recommended settings are H.264 video with AAC, MP3 or Opus audio, at 60, 30 or 25 fps. Recommended aspect ratios are 16:9, 9:16, 4:3, 3:4 and 1:1. For a product gallery that is mostly square stills, a 1:1 or 4:3 video sits more naturally beside the photos than a 16:9 one. Vertical 9:16 suits mobile-first stores.

For anything over 1 GB or 10 minutes, Shopify suggests hosting on YouTube or Vimeo and adding the link as external video. Links from other hosts aren't supported.

3D models

3D models must be GLB or USDZ, up to 500 MB. Shopify converts every model so both a GLB and a USDZ version exist, which covers web viewers and Apple's AR Quick Look. Files over 15 MB are optimized automatically: geometry and textures are reduced while the visual result is kept. Files under 15 MB are served as uploaded.

The catch is the theme. 3D models only display in themes that support them, which Shopify lists as all Online Store 2.0 themes built by Shopify and the Horizon theme family. On an older or third-party theme, a model can upload successfully and never appear on the product page.

Store-wide limits by Shopify plan

Images have no published per-plan count. Video and 3D models do: the two are counted together, across the whole store, and the cap depends on your plan. Total file storage and video storage are limited separately.

Video + 3D models per store, by plan
Basic / Starter / Retail
250
Grow
1,000
Advanced
5,000
Plus
50,000
Enterprise
100,000

Bar lengths are illustrative, not to scale. The counts are Shopify's published figures.

PlanTotal file storageVideo storage
Starter, Retail, Basic100 GB50 GB
Grow300 GB500 GB
Advanced500 GB500 GB
PlusNot listed separately2 TB
Enterprise10 TB10 TB

A 250-item cap on Basic sounds roomy until you add one video and one 3D model to each of 150 products. If you plan to add video across the catalogue, count before you start, and prefer a YouTube or Vimeo link for long-form content such as tutorials. Plus and Enterprise stores can ask Shopify Support to raise the limits.

Images are the cheap part

With no per-plan image count and 100 GB or more of storage on every plan, a full gallery of well-exported stills is rarely what fills a store. Unused video drafts and oversized originals are more likely culprits.

What to export: a working spec for product images

The limits tell you what Shopify will take. This is what to give it. Shopify's own guidance is that square images at 2048 × 2048 px usually display best. That's large enough for zoom on most themes and well inside both caps.

Inside the limits, still wrong

  • 5000 × 5000 PNG at 18 MB
  • Mixed ratios: some square, some 4:5, some 3:2
  • Adobe RGB or another wide-gamut profile
  • Filenames like shirt-large.jpg
  • Featured image chosen by upload order

A sound default

  • 2048 × 2048 JPEG or PNG, well under 1 MB
  • One aspect ratio across the catalogue
  • sRGB, metadata stripped
  • Descriptive, hyphenated filenames
  • Featured image set deliberately at position 1

Consistency matters as much as any single number. Shopify's guidance notes that featured images should share an aspect ratio so collection thumbnails line up. Mixed ratios are also the main reason themes crop products unexpectedly, covered in how Shopify themes crop product images.

The spec breaks down most often when images come from several sources: a photographer, a supplier feed, phone shots for new arrivals. Retouchable's Shopify integration is built for that step. It connects with read and write access to products only, with no access to orders or customers. You pick the product inside Retouchable, and the finished image is pushed back with its filename, alt text and gallery position set, including position 1 for the featured image. Exports come out as PNG, JPG or WebP at a consistent framing, so the result arrives inside Shopify's limits and matches the rest of the gallery.

Whatever tool you use, check four things before a bulk upload: every file is under 25 MP and 20 MB, every filename avoids the reserved endings, every image shares the catalogue's aspect ratio, and every product has a deliberate featured image.

Frequently Asked Questions

What is the maximum image size for Shopify products?

Shopify accepts product images up to 20 MB in file size and up to 25 megapixels in resolution, described as up to 5000 × 5000 px. A file has to pass both caps. For display, Shopify recommends square images at 2048 × 2048 px.

Why won't my image upload to Shopify when it's under 20 MB?

The most common cause is the 25-megapixel cap, which is separate from the 20 MB file-size cap. A small, compressed JPEG can still be refused if its width times height exceeds 25 million pixels. Other causes are an unsupported format or an aspect ratio more extreme than 100:1.

Should I upload WebP images to Shopify?

You can, but you don't need to. Shopify's image service detects which formats each shopper's browser supports and serves the best available format automatically. Uploading a high-quality JPEG or PNG and letting Shopify convert it is a reliable default.

How many videos and 3D models can a Shopify store have?

Video and 3D models are counted together across the store: 250 on Basic, Starter and Retail, 1,000 on Grow, 5,000 on Advanced, 50,000 on Plus and 100,000 on Enterprise. YouTube and Vimeo links don't count against Shopify's upload limits.

Why is my Shopify 3D model not showing on the product page?

3D models only display in themes that support them: all Online Store 2.0 themes built by Shopify and the Horizon theme family. On other themes, a GLB or USDZ file can upload successfully and still not appear. Check the theme first, then the file format and the 500 MB cap.

Get every product image inside Shopify's spec

Retouch, frame and push finished images straight to your Shopify products, with filename, alt text and featured position set for you.

Try Retouchable Free No credit card required