Snug Gallery / Guides

Which image formats work in a Shopify gallery (and why)

JPEG, PNG, GIF, WebP, HEIC and AVIF upload to Snug Gallery; SVG and JPEG XL do not. What Shopify's CDN serves to each browser, and which format to export.

The question usually arrives as a failed upload. A designer exported the gallery as JPEG XL because the new browsers display it, or a developer handed over SVG illustrations, or the photographer's folder is full of HEIC files straight from a phone. Some of those go through and some do not, and the ones that go through are not necessarily served to shoppers in the format you uploaded. This guide lists what Snug Gallery accepts, what Shopify does with each format once it is stored, and the one or two cases where converting before you upload is worth the trouble.

The list, in one place

Snug Gallery accepts six image formats in the admin uploader: JPEG, PNG, GIF, WebP, HEIC and AVIF, each up to 20 MB per file. Video uploads are MP4, MOV and WebM up to 250 MB, covered in the video guide. Anything else is refused before it leaves your browser, with a message naming the file. The customer photo form on the storefront is stricter: it takes JPEG, PNG, WebP and HEIC only, at 10 MB, and it checks the first bytes of the file rather than trusting the extension, because a public form cannot assume good faith.

Two formats people expect to see on that list are missing on purpose. SVG is a document format that can carry scripts and external references, which is why Shopify's own file upload treats it carefully and why a gallery that serves images into your theme does not accept it. JPEG XL is not supported by Shopify's image pipeline, so there is nothing useful the gallery could do with it. Both have workarounds below.

A detail that catches Linux and some Windows users: the browser sometimes reports an empty file type for .heic and .mov files. The uploader falls back to the extension in that case, so a file named correctly goes through even when the browser cannot identify it. A HEIC photo renamed to .jpg does not, because the content check inside Shopify will not match.

What Shopify does with the file after upload

Every image the gallery stores goes into your store's Shopify Files and is served from Shopify's CDN. That matters because the CDN does not serve the file you uploaded; it serves a version resized for the slot and, when the visitor's browser supports it, re-encoded into a more efficient format. Shopify's help centre documents that uploaded images can be delivered as WebP or AVIF depending on browser support, with the original kept for browsers that cannot display them. A JPEG you upload is, for most of your visitors, a WebP or AVIF by the time it lands on their screen.

The practical consequence is that converting to WebP before upload buys you very little. Shopify will make its own WebP from your JPEG anyway, and a WebP you export from an editor is already a lossy file that then gets re-encoded a second time. Upload the highest quality source you have within the 20 MB cap and let the CDN do the format work. The image size guide covers the dimensions side of the same decision.

HEIC is the exception that proves the rule. Shopify accepts it and converts it on their side, so an iPhone photo can go straight in, but colour handling on some HEIC files, particularly ones shot with wide colour gamut or portrait depth data, can come out flatter than the original. The HEIC guide has the before-and-after on that; the short version is that a quick export to JPEG on the phone is the safe path for hero images and unnecessary for a grid of forty.

Format by format

JPEG is the default and still the right choice for photographs. It has no transparency and no animation, which is fine for a gallery, and it is the format every tool exports well. Save at quality 85 to 92 and skip progressive encoding; Shopify's pipeline decides the delivery encoding regardless.

PNG is for images with hard edges, text or transparency: a logo wall, line illustrations, product cut-outs on a transparent background that you want to sit on the theme's background colour. For a photograph it is a waste, three to five times the file size of the equivalent JPEG for no visible gain, and more likely to hit the 20 MB cap on a large original. Note that the lightbox and the grid both place images on the theme background, so a transparent PNG shows whatever colour the theme has there; check it in dark mode if your theme offers one.

GIF uploads, and Shopify keeps it animated. The help centre notes that animated GIFs may be served as animated WebP to browsers that support it, which is smaller but otherwise identical. A GIF photograph, as opposed to an animation, is a mistake worth catching: 256 colours and dithering on a product photo look worse than any JPEG, so re-export from the source if you have it.

WebP and AVIF upload directly and are stored as you sent them. The main reason to upload them is that you already have them, for instance assets delivered by an agency that standardised on WebP. There is one caution with AVIF: it is slow to encode and some older design tools write files with an unusual colour profile that the CDN flattens. If an AVIF looks slightly off after upload, re-export as JPEG from the original and the problem goes away.

SVG, JPEG XL and other things that do not upload

For SVG illustrations, export a PNG at twice the display size, so a tile shown at 600 pixels wide gets a 1200 pixel PNG. Flat vector art compresses extremely well in PNG and will look sharp on high density screens. If the art has a transparent background, keep it; PNG preserves it and the grid will show the theme colour behind it. If the SVG is a logo that needs to appear in the theme rather than in a gallery, Shopify's theme editor and Files accept SVG directly, and the gallery is the wrong tool for it.

JPEG XL has had an odd year. Chrome added support in 2026 after dropping it earlier, Safari and Firefox display it, and camera and editing software has started offering it as an export. Google's search team said in October 2026 that Google Images does not yet index JPEG XL, which is a reason on its own not to publish in it even where you could. For a Shopify gallery the point is moot, because the format is not accepted; export JPEG from the same source. If you are handed only JXL files, most current image editors open them and will save a JPEG at full quality.

TIFF, BMP, PSD, RAW formats from cameras and PDF are refused as well. Each is a working or print format rather than a web one, and an export to JPEG at the longest side you need is the route for all of them. The upload errors guide describes doing that for a folder at a time.

A conversion workflow that does not fight the CDN

Keep your masters in whatever format the camera or designer produced, outside Shopify. Export a JPEG for photographs and a PNG for graphics at the size the image size guide recommends for the layout you are using, upload those, and stop. Do not pre-convert to WebP or AVIF, do not strip metadata with a third tool, and do not upload a 60 MB TIFF expecting the uploader to shrink it; the cap is 20 MB and the file is checked before any upload begins.

When you replace an image later, upload the new file as a new image and remove the old one rather than trying to keep the same filename. The CDN caches aggressively on the URL, and a new file gets a new URL, so shoppers see the change immediately. Snug Gallery keeps the title, caption and link on the item, so replacing the file does not mean redoing the words.

Frequently asked questions

Does a Shopify gallery support WebP images?

Yes, in both directions. You can upload WebP files to Snug Gallery, and Shopify's CDN serves WebP or AVIF versions of your JPEG and PNG uploads to browsers that support them, so even stores that only upload JPEG are delivering WebP to most visitors.

Why does my SVG not upload to the gallery?

SVG is not on the accepted list because it is a document format that can contain scripts and references to other files, which is a poor fit for user-managed images served into a storefront. Export the artwork as a PNG at twice the display width; flat vector art compresses well and stays sharp on high density screens.

Can I upload JPEG XL files to Snug Gallery?

No. Shopify's image pipeline does not handle JPEG XL, so the gallery refuses the file before upload. Open the JXL in a current image editor and save a JPEG at full quality. Google also said in October 2026 that Google Images does not yet index JPEG XL, so publishing in it would not help image search either.

Should I convert iPhone HEIC photos to JPEG before uploading?

Not usually. HEIC uploads directly and Shopify converts it for delivery. Convert the handful of hero images where colour matters most, because some HEIC files with wide gamut or depth data come out slightly flat after conversion, and leave the rest of a large grid as they are.

More guides