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.
| Media | Formats | Max file size | Max dimensions / length |
|---|---|---|---|
| Images | JPEG, PNG, WebP, HEIC, GIF (product media also takes TIFF, BMP, SVG) | 20 MB | 5000 × 5000 px or 25 MP; aspect ratio between 100:1 and 1:100 |
| Video | MP4, MOV, WebM | 1 GB | 10 minutes; up to 4096 × 2160 (4K); at least 100 px each side; up to 120 fps |
| 3D models | GLB, USDZ | 500 MB | Optimized automatically above 15 MB |
| External video | YouTube or Vimeo URL | No Shopify limit | Other 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.
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.
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.
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 in | Safer alternative |
|---|---|
| linen-shirt-small.jpg | linen-shirt-size-s.jpg |
| ceramic-mug-large.jpg | ceramic-mug-12oz-front.jpg |
| wallet-thumb.jpg | wallet-detail-stitching.jpg |
| lamp-icon.png | lamp-brass-side.png |
| product_image_5x4.jpeg | product-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.
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.
Bar lengths are illustrative, not to scale. The counts are Shopify's published figures.
| Plan | Total file storage | Video storage |
|---|---|---|
| Starter, Retail, Basic | 100 GB | 50 GB |
| Grow | 300 GB | 500 GB |
| Advanced | 500 GB | 500 GB |
| Plus | Not listed separately | 2 TB |
| Enterprise | 10 TB | 10 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.
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.