Etsy Listing Photo Size: Etsy's Rules and Files That Meet Them

Etsy's 2000 pixel figure is a recommendation for image quality: the listing form warns below 2000 pixels wide, and Etsy says that warning "is only a suggestion and you should be able to continue publishing". The 635 pixel floor on the first photo is the number tied to search placement.

These are Etsy's own lines, read on 8 October 2026 at three help articles, with the date each article was last edited:

Several figures that circulate as Etsy rules are not on the current image article. The 72 PPI line and "2000px for the shortest side" come from Etsy's community announcement of 24 July 2023, which read: "Recommended size is 2000px for the shortest side, and a resolution of 72PPI."

The current article sets no PPI and no aspect ratio number. PPI is a tag inside the file and does not change its pixels: the render docs describe SudoMock's dpi option the same way, as metadata that leaves the pixel size to image_size. A file of 2679 by 2000 pixels is the same image at 72 or at 300 PPI.

Etsy's own pages also differ in two places. The variations article still says "You can add up to ten photos" in its photo step, while the listing article says 20. The upload warning is 1 MB on the image article and 300k on the listing article.

In a SudoMock render, image_size sets the output width and the height follows the template's own shape. So the width that gives 2000 pixels on both sides depends on the template: 2000 for square templates, more for landscape ones.

For a landscape template, multiply 2000 by the template's width divided by its height and round up. A PSD mockup returns its size as data.width and data.height, a photo mockup as data.source_width and data.source_height. The photo rendered for this page is 4800 by 3584 pixels. It looks like 4:3, but a width of 2667 returned 2667 by 1991 pixels, nine short of 2000 in height. The same rule gives 2679, and 2679 returned exactly 2679 by 2000.

One request renders the design on the template in a format Etsy lists, at the width you set. This is the photo mockup render that made the files below, with the IDs and the design URL as placeholders:

curl -X POST https://api.sudomock.com/api/v1/photo-mockups/YOUR_PHOTO_MOCKUP_ID/render \
  -H "x-api-key: $SUDOMOCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "print_areas": [
      { "uuid": "YOUR_PRINT_AREA_UUID",
        "artwork_url": "https://example.com/designs/botanical-print.png",
        "adjustments": { "blend_mode": "normal" } }
    ],
    "export_options": { "image_format": "jpg", "image_size": 1024, "quality": 80 }
  }'

const response = await fetch('https://api.sudomock.com/api/v1/photo-mockups/YOUR_PHOTO_MOCKUP_ID/render', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.SUDOMOCK_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "print_areas": [
      {
        "uuid": "YOUR_PRINT_AREA_UUID",
        "artwork_url": "https://example.com/designs/botanical-print.png",
        "adjustments": {
          "blend_mode": "normal"
        }
      }
    ],
    "export_options": {
      "image_format": "jpg",
      "image_size": 1024,
      "quality": 80
    }
  }),
});

const data = await response.json();
console.log(data);

import os
import requests

response = requests.post(
    "https://api.sudomock.com/api/v1/photo-mockups/YOUR_PHOTO_MOCKUP_ID/render",
    headers={
        "x-api-key": os.environ["SUDOMOCK_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "print_areas": [
            {
                "uuid": "YOUR_PRINT_AREA_UUID",
                "artwork_url": "https://example.com/designs/botanical-print.png",
                "adjustments": {
                    "blend_mode": "normal",
                },
            },
        ],
        "export_options": {
            "image_format": "jpg",
            "image_size": 1024,
            "quality": 80,
        },
    },
)

print(response.json())

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	payload := []byte(`{
  "print_areas": [
    {
      "uuid": "YOUR_PRINT_AREA_UUID",
      "artwork_url": "https://example.com/designs/botanical-print.png",
      "adjustments": {
        "blend_mode": "normal"
      }
    }
  ],
  "export_options": {
    "image_format": "jpg",
    "image_size": 1024,
    "quality": 80
  }
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/photo-mockups/YOUR_PHOTO_MOCKUP_ID/render", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SUDOMOCK_API_KEY"))
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php

$payload = <<<'JSON'
{
  "print_areas": [
    {
      "uuid": "YOUR_PRINT_AREA_UUID",
      "artwork_url": "https://example.com/designs/botanical-print.png",
      "adjustments": {
        "blend_mode": "normal"
      }
    }
  ],
  "export_options": {
    "image_format": "jpg",
    "image_size": 1024,
    "quality": 80
  }
}
JSON;

$ch = curl_init('https://api.sudomock.com/api/v1/photo-mockups/YOUR_PHOTO_MOCKUP_ID/render');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . getenv('SUDOMOCK_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

For the listing files, set image_size to the width the table gives for your template: the files below used 2679. The image URL comes back in data.print_files[0].export_path.

Set image_format to jpg in every request. The API returns WebP when the format is left out, and WebP is not on Etsy's list of supported image types. A PSD template takes the same export_options in Render a PSD mockup.

All three files below are SudoMock renders made on 8 October 2026 from one photo mockup at image_size 2679, and each came back at exactly 2679 by 2000 pixels. At quality 90 the JPG is 799,805 bytes, under Etsy's 1 MB line, and quality 80 is about half that size.

A SudoMock render on a photo mockup, shown here at 1600 px. The product photo was made with an image model for this example.

At full size the three files are hard to tell apart. The crop below shows the same 700 by 520 pixel area of the quality 90 and quality 70 files at 100 percent.

The same area of the quality 90 and quality 70 renders at 100 percent.

Etsy compresses uploads again on its side: "Images may appear less sharp after being uploaded due to compression of the image files." Quality 80 keeps the file well under 1 MB with room to spare, and quality 70 sits just above the 300k line of the listing article.

Etsy's first photo sets the shape of the photos after it, so render the whole set from templates of one shape. For colour or style variations, render one image per option: Etsy lets a seller link photos to 20 options of a variation.

1. Choose templates of one shape for the listing, landscape or square for the first photo.
2. Keep the product centred with space around it. Etsy crops the first photo "to square, portrait, and landscape thumbnails" and asks for "enough of a border" so none of the product is lost.
3. Render each design on each template, one request per colour, with image_format jpg and the width from the table. Send the requests in parallel: the average SudoMock render finishes in under a second.
4. Upload the files in listing order, then link each colour's photo to its variation option.

To send the photos to Etsy by script, Etsy's Open API takes the image file per listing: Etsy listing generator shows the draft and upload calls, and How to Automate Etsy Product Mockups runs the render loop over a catalogue.

Render one listing photo with the request above at the width your template needs, check its pixels and bytes, then render the rest of the set. With a product photo, create a mockup from a product photo: its print area is found automatically. With no template yet, start from the mockup templates for Etsy sellers. Without code, the SudoMock node in n8n takes the same format, width and quality settings for a PSD template (PSD Mockup: Render): see the n8n integration guide. The Etsy mockups use case covers the rest of a listing workflow.