July 30, 2026 · 9 min read
Etsy's File Size Limit: Everyone Quotes a Different Number
Go looking for Etsy's maximum image file size and you'll come back with four answers. One megabyte. Ten. Twenty. Fifty. Every one of them stated with total confidence, usually in a listicle with a stock photo of a woman wrapping a candle.
They're all guessing, and the reason is that Etsy never published a hard cap.
What Etsy actually says is narrower and more useful: images larger than 1 MB may not finish uploading, particularly on a slower connection. That's a reliability warning, not a rejection rule. Which means the failure mode isn't a red error message. It's an upload that stalls, or hangs, or quietly drops one photo from a listing you thought had eight.
You find out three weeks later. If you find out at all.
Table of Contents
- What Etsy Actually Specifies
- The Transparency Problem
- The Two Numbers Worth Remembering
- Getting a Photo Ready
- Etsy Compresses Your Photos Again
- Quality Settings for Handmade Work
- Every Other Image in Your Shop
- Doing a Batch
- When Uploads Fail
- Common Questions
1. What Etsy Actually Specifies
| Spec | Requirement |
|---|---|
| Recommended listing photo | 2,000 px or more on both dimensions |
| First photo minimum | 635 px — below this the listing ranks lower |
| File size guidance | Over 1 MB may fail to upload |
| Formats | .jpg, .gif, .png, .svg, .heic — and nothing else |
| Animated GIF | Not supported |
| Transparent PNG | Not supported; transparency renders black |
| Photos per listing | 10, plus one video |
| Colour space | sRGB |
Look at what's absent from that format list. WebP. If you've been optimising images for your own site in WebP — and you should be — you'll need to convert before uploading here. Sellers running a Shopify store alongside an Etsy shop hit this constantly, because the correct answer on one platform is a rejected file on the other.
Then there's 635 px, which almost nobody mentions. It isn't an upload minimum; Etsy will happily accept a smaller first photo. It's a search ranking threshold. Drop below it on either dimension and the listing surfaces lower in results. No warning, no error, no notification. Just less traffic.
2. The Transparency Problem
This one gets its own section because it ruins listings and Etsy doesn't warn you.
Etsy doesn't support transparency in PNGs. Transparent areas come out solid black.
If you sell digital downloads, clipart, printables, logos, sublimation designs or SVG cut files, transparent PNGs are probably your actual product. Upload one as a listing photo and shoppers see your design sitting on a black rectangle.
The fix is to separate the two jobs. Your transparent file stays exactly as it is — that's what the buyer downloads, and nothing about it changes. What you need is a separate listing photo, made by flattening the design onto something.
White or a light neutral gives you a clean product shot. A mockup gives you context: a mug, a tee, a framed wall scene. Either way, export the flattened version as JPEG, because once transparency is gone JPEG is smaller and entirely adequate.
Never upload the raw transparent file, not even in a "here's what you get" slot. If you want to communicate that the file has a transparent background, show it on a checkerboard graphic instead.
Animated GIFs have the same shape of problem: accepted as files, but they won't animate. Use the video slot.
3. The Two Numbers Worth Remembering
2,000 pixels on the shortest side is Etsy's recommendation and it's what gives you a genuinely sharp zoom. Etsy buyers zoom constantly. They're checking a weave, a solder joint, the way a glaze pooled. Undersized photos read as amateur on a marketplace where craft quality is the entire pitch.
1 MB is the reliability line. Not a wall, but the point past which uploads start failing in ways you won't notice. Since the failure is silent, staying under it is just the sensible default.
Target: 2,000 × 2,000 pixels, JPEG, 200–800 KB.
That's achievable on essentially any photograph without visible loss. If you can't get a 2,000 px image under 1 MB at a reasonable quality setting, nine times out of ten you saved it as a PNG when JPEG would have done.
4. Getting a Photo Ready
- Start from your highest-resolution original. Etsy runs its own compression after upload, so a clean sharp source matters more here than on most platforms.
- Crop your first photo square. Etsy crops thumbnails differently across desktop search, mobile search and the listing page itself. A square composition with the product centred and a comfortable margin survives all of them. Push something critical against the top or bottom edge and it'll get cut somewhere.
- Resize to 2,000 × 2,000. Bigger gives you nothing Etsy will display and makes the 1 MB target harder.
- Flatten any transparency. Not optional. See section 2.
- Convert to JPEG. Not WebP, which is rejected. Not PNG unless you've got a reason.
- Compress at quality 80–88. Etsy compresses again on their end, so leave a little headroom — but not so much that you're stacking two heavy losses.
- Check the file size. 200–800 KB. Over 1 MB, drop the quality or check you didn't leave it as PNG.
- Do all ten slots. Listings with seven or more photos consistently outperform thinner ones, so the batch is the work, not the hero shot.
Resize, flatten, convert and compress collapse into one browser-based pass, which keeps this under a minute per listing. CompressFile.pro does it locally, which is worth something on Etsy specifically — your product photography is usually your own original work, and there's no reason to hand copies to a third-party service just to make them smaller.
5. Etsy Compresses Your Photos Again
This changes how you should think about quality settings, so it's worth sitting with.
Etsy automatically compresses and resizes listing photos to deliver them across devices. The file you upload is not the file buyers see.
Two things follow. First, start clean, because Etsy's compression works from whatever you hand it — a sharp, well-lit 2,000 px source survives that pass far better than something already soft. Second, don't compress hard yourself. Export at quality 65 and let Etsy compress again and you've stacked two lossy passes, which shows up immediately on fine patterns, embroidery, glazes and gradients.
Quality 80–88 on your end is the balance. Small enough to upload reliably, clean enough that Etsy's pass doesn't tip it into visible damage.
Then go look. Open your live listing on a phone and zoom in. That's the only test that reflects what a buyer sees, and virtually nobody does it.
6. Quality Settings for Handmade Work
Etsy is a detail marketplace. People pay a premium precisely because something was made by hand, and the evidence for that lives in the texture.
| What you sell | Quality | Why |
|---|---|---|
| Jewellery, metalwork | 88–92 | Solder joints, hammering, patina, facets |
| Knitwear, weaving, fibre art | 88–92 | Stitch definition is the product |
| Embroidery, cross-stitch | 88–92 | Thread detail and count |
| Ceramics, glazed pottery | 85–90 | Glaze variation, surface texture |
| Woodwork, furniture | 85–90 | Grain and finish |
| Candles, soap, bath | 82–86 | Flat surfaces and packaging |
| Prints, wall art | 85–90 | Paper texture, colour accuracy |
| Digital downloads, mockups | 85–90 | Sharp edges and text in mockup scenes |
| Vintage | 88–92 | Buyers are inspecting for wear |
| Styled lifestyle shots | 80–85 | Context, not diagnosis |
That vintage row deserves a note. Buyers of vintage goods zoom specifically to assess condition. A compressed photo that smooths over a scuff doesn't win you a sale, it wins you a return.
7. Every Other Image in Your Shop
| Image | Size |
|---|---|
| Listing photo | 2,000 × 2,000 px |
| First listing photo, minimum | 635 px both dimensions |
| Shop logo | 500 × 500 px |
| Profile photo | 400 × 400 px |
| Team logo | 170 × 100 px |
| Order receipt banner, minimum | 760 × 100 px |
Keep these under 1 MB as well. You upload them so rarely that compression gets forgotten, and they're a routine cause of "my shop settings won't save."
8. Doing a Batch
Cull before you edit. Choose your ten shots per listing first — processing photos you'll never use wastes more time than any other step in this workflow.
Do your editing at full resolution: colour correction, background cleanup, cropping. Then resize the whole batch to 2,000 × 2,000 in one operation, flatten transparency across it if you work with digital products, and convert and compress in a single pass at whatever quality your category calls for.
Check the largest file in the batch. If the biggest one is under 1 MB, they all are.
Name files descriptively even though Etsy doesn't use filenames for SEO. You'll be grateful when you re-upload or cross-list later.
Upload on a connection you trust. Given the 1 MB reliability threshold, a shaky connection plus heavy files is exactly the combination that produces photos silently going missing. Then open each published listing and count. Confirm all ten actually arrived.
9. When Uploads Fail
| Symptom | Cause | Fix |
|---|---|---|
| Upload stalls, never completes | Over 1 MB on a slow connection | Compress under 800 KB |
| Photo missing from the listing | Upload dropped mid-batch | Re-upload, keep files under 1 MB |
| Black background where it should be clear | Transparent PNG | Flatten onto white or a mockup |
| GIF won't animate | Animated GIFs unsupported | Use the video slot |
| File rejected outright | Unsupported format, usually WebP | Convert to JPEG or PNG |
| Listing ranks poorly, nothing else wrong | First photo under 635 px | Re-upload at 2,000 px |
| Soft on mobile | Over-compressed, then compressed again | Re-export at 85+ |
| Detail cropped in search thumbnails | Non-square composition | Crop square, centre with margin |
10. Common Questions
So what is Etsy's maximum file size? There isn't a published one. Etsy's official guidance is that images over 1 MB may not finish uploading, especially on slower connections. Treat 1 MB as the practical ceiling. The 10 MB, 20 MB and 50 MB figures floating around aren't from Etsy.
Can I upload WebP? No. .jpg, .gif, .png, .svg and .heic only.
Why is my PNG showing a black background? Etsy doesn't support transparency. Flatten onto a solid background first.
Does file size affect search ranking? File size, no. Pixel dimensions, yes — a first photo under 635 px pushes the listing down. Beyond that, image quality drives click-through, which affects ranking indirectly.
Should I upload at 3,000 px to be safe? It makes 1 MB harder to hit and Etsy compresses it down regardless. 2,000 px is enough for zoom on any current display. For filigree jewellery or dense embroidery, 2,400 px is a fair compromise.
How many photos? All ten if you can manage it. Seven or more measurably outperforms fewer. Vary them: clean product shot, scale reference, detail close-up, worn or in use, packaging, customisation options.
Why do my images look worse on Etsy than on my screen? Etsy's own compression pass. Give it a sharper source and don't compress hard yourself — 85 or above leaves room.
The Five-Second Checklist
- 2,000 × 2,000 px, JPEG, under 1 MB.
- No transparency anywhere. Flatten first.
- Not WebP.
- First photo above 635 px on both sides.
- Quality 85+, because Etsy compresses it again.
Resize, flatten and compress a full listing set in one go — in your browser, nothing uploaded anywhere.