Etsy listing photo requirements
Etsy's official guidance is unusually specific about file size: images over 1 MB may not finish uploading. That single sentence changes how a bulk export should be built.
What Etsy actually says
| Requirement | Etsy’s guidance | What it means for a batch |
|---|---|---|
| Listing photo size | At least 2000 px width and height recommended | Square 2000 px is a safe, simple target. |
| First photo minimum | At least 635 px | Below this, the listing may rank lower in search. |
| Upload size | Images larger than 1 MB may not finish uploading | Compress to roughly 1 MB or less, especially on slow connections. |
| File types | .jpg .gif .png .svg .heic | JPEG is the most predictable for photographs. |
| Transparency | Transparent PNG is not supported | Flatten onto a background before uploading. |
| Animation | Animated GIF is not supported | Use a static first photo. |
| Authenticity | At least one unedited photo of the real item against a real background | Do not turn every photo into a white-background render. |
The 1 MB rule is the useful one
Most “Etsy image size” articles stop at 2000 px. The upload warning is more actionable: a 2000 px JPEG exported at high quality can easily land at 1.5–3 MB, and Etsy tells sellers those files may not finish uploading. Catalogry's Etsy preset therefore starts at 2000 × 2000 and progressively lowers JPEG quality until the file is around 1 MB, while keeping the pixel dimensions intact.
Compression quality is a trade-off, not a free win. If the source is a detailed textile or a fine art print, check the exported file at 100% zoom before uploading 200 listings.
Do not flatten your only real photo
Etsy asks for at least one unedited photo of the actual item against a real background. A catalogue where every image is a padded, compressed, white-background square can satisfy the dimensions and still fail the authenticity expectation. Keep one honest, unedited photo per listing — and let the processed images do the catalogue work.
A practical bulk workflow
- Export your Etsy listings with the SKU or listing ID and the image filenames.
- Keep one unedited photo per product out of the batch.
- Use the Etsy preset, square 2000 px, and let the 1 MB target do its job.
- Check the manifest: every SKU should have at least one image.
- Upload the first photo manually and verify the crop on mobile.
What Catalogry checks — and what it cannot
Checked locally
- Source below 635 px (blocking)
- Source below 2000 px (warning)
- Output size against a ~1 MB target
- Transparent source versus a JPEG export
- Duplicate filenames after templating
- SKUs in the CSV with no image
Not checked
- Whether the photo is genuinely unedited
- Whether the item matches the listing
- Etsy’s category-specific rules
- Mobile crop in the Etsy app
- Colour accuracy on a phone screen
- Whether a reviewer will accept the photo
Frequently asked
Is 2000 × 2000 the right shape for Etsy?
Etsy’s guidance is about minimum width and height, not a mandated ratio. Square is the simplest consistent choice for a catalogue; 4:3 is also common. Consistency across a shop matters more than the exact ratio.
Can I upload a transparent PNG?
Etsy explicitly says transparent PNGs are not supported. Flatten the image onto white or another background first.
What if my file is still over 1 MB?
Lower the quality target, simplify the image, or reduce dimensions slightly. Catalogry reports any file that could not reach the target instead of silently pretending it succeeded.
Sources and verification
| Source | Access | Checked |
|---|---|---|
| Etsy Help — Requirements and best practices for images in your Etsy shop Read directly on 2026-11-16. This page contains the 2000 px, 635 px, 1 MB and file-type guidance quoted below. | Read directly | 2026-11-16 |