Etsy reference

Etsy Listing Photo Requirements: File Types, Sizes and Upload Fixes

Check Etsy's supported photo types, pixel recommendations, upload-size warnings and thumbnail workflow using directly linked Etsy help sources.

Last checked September 23, 2026

Check the file type before exporting

Etsy's current image guidance lists JPG, GIF, PNG, SVG and HEIC. It does not list WebP, even though Image Prep can export WebP and Image QA can inspect it. For an Etsy upload, choose JPG or PNG in this tool and confirm the file type in the listing draft. Renaming a WebP file does not convert it.

Etsy says animated GIFs and transparent PNGs are not supported as expected; transparent areas may appear black. Image Prep composites transparent inputs onto the selected background, so choose that background deliberately. Check Etsy's linked requirements again if its supported formats change.

Treat pixel dimensions as guidance, not a magic threshold

Etsy recommends listing images at least 2000 pixels wide and high. Its image guidance also says the first photo should be at least 635 pixels in both dimensions to avoid reduced search appearance. The Search Visibility page separately recommends a 2000 × 2000 main photo. These are platform recommendations; meeting a pixel count alone does not guarantee search placement, acceptance or a sharp result.

The guidance allows a landscape or square first image and recommends leaving room around the subject for thumbnail treatment. Do not enlarge a small original just to hit a number: added canvas pixels cannot restore missing detail. Use Etsy's own thumbnail adjustment tool to inspect the actual crop.

Upload size advice is not one universal cap

Etsy's image-requirements page warns that files over 1 MB may not finish uploading, especially on a slow connection. Its listing-creation help page separately says images over 300 KB may time out. Those statements are not the same as a single guaranteed file-size limit; connection conditions and the upload flow matter.

If an upload stalls, test one image on a stable connection, then reduce dimensions or JPG quality in small steps and compare the result. Keep text, texture and product edges legible. Check the draft listing rather than treating a particular kilobyte target as a platform rule.

Check composition, color and the final listing

Etsy may compress images after upload, which can make them look less sharp. Etsy also converts images to sRGB; if colors shift, convert the source to sRGB before uploading and compare the listing preview with the original.

The Search Visibility page checks more than image dimensions: it also calls out a clear main photo of one finished product rather than a collage, at least one listing photo, category details and shop/customer-service signals. Treat the page as a diagnostic checklist, not a ranking promise. Image optimization cannot replace accurate listing information or a useful product offer.

A repeatable pre-publish check

Use representative images that expose different risks: the main product view, an edge-sensitive detail and an image containing small text or transparency. A crop preview catches some framing problems, but only Etsy's own draft and thumbnail previews show how the platform currently presents the upload.

  1. Confirm that the export type is supported by Etsy; use JPG or PNG from Image Prep.
  2. Check the source dimensions and composition without enlarging a low-detail original to chase a number.
  3. Inspect the exported file at normal size and at 100%, including edges, text and important color.
  4. Upload one representative file to a draft and inspect Etsy's thumbnail adjustment and listing preview.
  5. If an upload times out, test one file and adjust dimensions or compression gradually instead of assuming a universal size cap.
  6. Record the official source and checked date when you reuse this workflow.

Known limits

Image QA can identify a file type and dimensions; Image Prep can create local exports. Neither tool checks Etsy account status, listing policy, image attractiveness, accurate product representation or the exact crop on every search and collection surface. A correct export is one technical check, not a promise of visibility or sales.

Sources checked