Photography guide
Which Etsy banner numbers our rule module actually stores
Four Etsy slots carry a size our checker can measure a file against. The other figures are either recorded recommendations or, in the collage case, arithmetic over a per-image minimum.
The sizes a file can be measured against
Our Etsy rule module records a size that a file can be measured against for four slots: the order receipt banner at 760x100, the mini shop banner at 1200x160, the big shop banner at 1200x300, and the collage banner through its variants (evaluate.ts:156-158). Five further slots carry neither a requirement nor variants, and that set is held in place by a frozen test (etsy.test.ts:152-169), so for those five there is simply no recorded size for a file to be compared with.
Seven slots also carry a recorded recommendation (evaluate.ts:183). A recommendation and a requirement are different kinds of value, and that distinction is settled on the page about photographs that pass Etsy's rules rather than re-derived here.
Every number below is the value our rule module records as of the 2026-08-18 repository snapshot, not the marketplace's current published policy, and every statement is about how our checker evaluates a file you give it - not about how the marketplace's own uploader treats the same file.
How the module turns a comparison into an outcome - which checks end as failures and which end only as warnings (evaluate.ts:187-190) - is a separate subject that this page does not open.
What the module records, slot by slot
Read from the repository snapshot of 2026-08-18. The right-hand column gives the file and line the value is read from, so you can check it yourself.
| Slot | Recorded value | Kind of value | Read from |
|---|---|---|---|
| Order receipt banner | 760 x 100 | Requirement | evaluate.ts:156-158 |
| Mini shop banner | 1200 x 160 | Requirement | evaluate.ts:156-158 |
| Mini shop banner | 1600 x 213 | Recommendation | etsy.ts:258-284 |
| Big shop banner | 1200 x 300 | Requirement | evaluate.ts:156-158 |
| Big shop banner | 1600 x 400 | Recommendation | etsy.ts:258-284 |
| Collage banner, two images | 600 x 300 per image | Requirement | etsy.ts:311-328 |
| Collage banner, three images | 400 x 300 per image | Requirement | etsy.ts:311-328 |
| Collage banner, four images | 300 x 300 per image | Requirement | etsy.ts:311-328 |
| The other five slots | no size recorded | None | etsy.test.ts:152-169 |
Mini and big share a width, not a height
The two shop banners are separate slots, and the sizes recorded for them differ only in height: mini 1600x213 and big 1600x400, both 1600 wide (etsy.ts:258-284). Carrying a single figure between the two slots therefore gets the width right and the height wrong.
The module carries a note of its own beside these values, marking 1600x400 as a common confusion (etsy.ts:266). That note is the reason both heights are printed here rather than one.
The collage minimum is stated per image
The collage is the one slot where the recorded minimum describes a single image rather than the finished banner.
- Each collage variant records a minimum per image.
- Two images 600x300 each, three images 400x300 each, four images 300x300 each (etsy.ts:311-328). The number changes with the count because it describes one image, not the assembled banner.
- A 1200-wide collage figure is arithmetic, not a recorded value.
- It is a per-image width multiplied by the number of images, and no such literal appears in the module file for the collage slot (etsy.ts:311-328).
- The 1200 in the two shop banner requirements is a different thing, and it is stored.
- Mini records 1200x160 and big records 1200x300 as literal requirement values read straight from the module (evaluate.ts:156-158). These two values have nothing to do with the collage arithmetic in the line above.
- The checker measures a collage file against the two-image minimum.
- That minimum is 600x300 (evaluate.ts:156), so a file 600 px wide passes the collage requirement. The checker does not read how many images your layout contains, which is why the per-image variant has to be applied by you while you build the file.
Checking a file you already have
Each step uses only values recorded in the module.
- Name the slot first: order receipt, mini shop banner, big shop banner, collage, or one of the five that record no size.
- Read the file's pixel width and height, and compare both against the requirement recorded for that slot.
- For a collage, measure each source image against the variant for the number of images you are placing - two, three or four - rather than measuring the assembled banner.
- Remember that the collage file itself is compared against the two-image minimum of 600x300 (evaluate.ts:156), so a passing collage file is not evidence that each panel met its own variant.
- If you want the recommended shop banner sizes rather than the requirements, use 1600x213 for mini and 1600x400 for big (etsy.ts:258-284).
- If the slot is one of the five that record no size, stop looking for a number - there is none, and the size rule has nothing to compare against (etsy.test.ts:152-169).
What this page does not settle
- The marketplace's current published policy. Every figure here is the value our rule module records as of the 2026-08-18 repository snapshot.
- How the marketplace's own uploader or validator treats a file. This page describes only how our checker evaluates one.
- How the module turns a comparison into an outcome for a file. That mechanism belongs to a separate page.
- Any effect of a size on ranking, impressions or conversion. No such claim is made anywhere on this page.
- Format, animation and transparency outcomes. Those checks are separate from size and remain possible on the five slots that record no size.
- The minimums that apply to the photographs you send into the app, which are a different set of numbers from these shop branding sizes.
Questions
What size should an Etsy shop banner be, and does the wrong size actually break anything?
For the mini shop banner our module records 1200x160 as the requirement and 1600x213 as the recommendation; for the big shop banner it records 1200x300 and 1600x400 (evaluate.ts:156-158, etsy.ts:258-284). Only four slots carry a size at all - those two banners, the order receipt banner at 760x100 and the collage variants - so those are the only slots where a size can be measured against your file. All values are as recorded in the repository snapshot of 2026-08-18.
Is 1600x400 the right Etsy banner size?
It is the size our module records for the big shop banner. The mini shop banner records 1600x213 - the same width, a different height (etsy.ts:258-284). The module carries a note of its own marking 1600x400 as a common confusion (etsy.ts:266).
What size should each image in a collage banner be?
The minimum is recorded per image: 600x300 for two images, 400x300 for three, 300x300 for four (etsy.ts:311-328). A 1200-wide collage figure is a per-image width multiplied by the image count and is not stored anywhere in the module file. Our checker compares the collage file against the two-image minimum of 600x300 (evaluate.ts:156) and does not read how many images you actually placed.
Do the remaining Etsy slots have a recorded size?
No. Five slots carry neither a requirement nor variants, and that set is frozen by a test (etsy.test.ts:152-169). This rule covers size only, so format, animation and transparency checks are still separate matters for those slots.