DEV Community

Casper Tran
Casper Tran

Posted on

Etsy image URLs: the size token takes any width, and the .jpg is WebP in Chrome

An Etsy listing photo has an address shaped like this:

https://i.etsystatic.com/<shop>/r/il/<hash>/<id>/il_794xN.<id>_<suffix>.jpg
Enter fullscreen mode Exit fullscreen mode

Today (20 November 2026) I fetched one listing photo from i.etsystatic.com with curl in 31 variants to see which parts of that address the CDN reads. The photo is stored at 2947×3000. All sizes below are for that one image, so your byte counts will differ, but the rules should carry over.

The size token takes any width

With no Accept header, every request came back as JPEG:

Token Pixels Bytes
il_75x75 75×75 2,222
il_170x135 170×135 5,928
il_300x300 300×300 15,193
il_340x270 340×270 16,395
il_570xN 570×580 39,151
il_794xN 794×808 65,007
il_1140xN 1140×1161 118,966
il_1588xN 1588×1617 244,040
il_fullxfull 2947×3000 1,164,396

WxN fits the width and lets the height follow the photo's proportions. WxH crops to exactly that box, which is why the 340×270 thumbnail of a nearly square photo loses its top and bottom.

Then I tried widths I made up. il_1000xN returned 1000×1018 (94,450 bytes), il_2000xN returned 2000×2036 (445,416 bytes), and il_600x600 returned a 600×600 crop (42,106 bytes). So the token is a resize instruction the server parses, and you can ask for the width your layout needs.

fullxfull is the ceiling, and bigger numbers upscale

il_fullxfull returned 2947×3000. il_NxN returned the same file, byte for byte.

il_5000xN returned a 5000×5090 JPEG of 2,671,221 bytes. That is the same photo stretched: more than twice the bytes and no extra detail. If you are collecting originals, rewrite to il_fullxfull and leave the big numbers alone.

full() { echo "$1" | sed -E 's#/il_[0-9A-Za-z]+x[0-9A-Za-z]+\.#/il_fullxfull.#'; }
Enter fullscreen mode Exit fullscreen mode

The .jpg is WebP when the client lists WebP

The address always ends in .jpg. What comes back depends on the Accept header:

Accept 794xN fullxfull
none, */* or image/jpeg image/jpeg, 65,007 image/jpeg, 1,164,396
image/webp image/webp, 37,524 image/webp, 903,692
Chrome's image header (image/avif,image/webp,...) image/webp, 37,524 image/webp, 903,692
image/avif only image/jpeg, 65,007 image/jpeg, 1,164,396

WebP is 42% smaller at 794 px and 22% smaller at full size. I never got AVIF, even when it was the only modern format in the header.

The response carries vary: Accept, comes through Fastly, and is cached with cache-control: public, max-age=365000000, immutable, which is about 11.6 years.

This explains a common complaint. Open the full-size photo in a Chrome tab, choose "Save image as", and you get a .webp, because a tab navigation sends an Accept header that lists image/webp. fetch() sends */* unless you set the header yourself, so a script that fetches the same address gets the JPEG.

You cannot change the extension

Swapping .jpg for .webp, .png or .avif returned HTTP 404 each time. The body of that 404 is a 49-byte, 10×10 GIF with content-type: image/gif. A downloader that only checks "did an image come back" will happily save it, so check the status code.

The /r/ segment made no difference

I removed /r/ from the path, then replaced it with /c/. Both returned the same 65,007-byte file as the original address. I don't know what Etsy uses the segment for; for this photo the CDN ignored it.

Checking a photo yourself

A='image/avif,image/webp,image/apng,image/svg+xml,image/*,*/*;q=0.8'
u='<an il_794xN address copied from a listing>'
for h in '*/*' "$A"; do
  curl -s -H "Accept: $h" -o /dev/null \
    -w "%{http_code} %{content_type} %{size_download}\n" "$(full "$u")"
done
Enter fullscreen mode Exit fullscreen mode

The first line is what a script gets and the second is what Chrome gets.

I build PixLasso, a Chrome and Edge extension that applies this rewrite when it collects the images on a page, and its free right-click "Save image as JPG" re-encodes the WebP on your machine. The manual steps, with the size table for sellers who want their own listing photos back, are in the Etsy listing photos guide.

Top comments (0)