我们把散落在帮助中心与卖家社区的图片规则整理成可核对条目。每条写清「结论 + 出处」。 官方表述可能更新 —— 以链接内原文为准。
Condensed, source-backed notes on Etsy photo rules. Official wording can change — always verify the linked source.
Etsy 只在图片最短边至少 2000 像素时启用悬停放大（hover-to-zoom）。 低于该门槛时，放大功能会被完全关闭，不是“模糊放大”，而是买家根本放不了。
Etsy enables hover-to-zoom only when the shortest side is at least 2000px. Below that, zoom is turned off entirely — not a soft zoom.
出处 / Source： Etsy Help — Adding photos and video （Etsy 官方对图片缩放行为的说明；另有若干第三方博客持相同结论，此处不逐一外链）
Etsy 表示：listing 的第一张照片宽高均应至少 635 像素， 否则可能在搜索结果中展示得更靠后。这是「能上架」之上的排序相关门槛。
Etsy’s guidance: the first listing photo should be at least 635px in width and height, or it may show lower in search.
出处 / Source： Etsy Help — Tips for great listing photos （第三方汇总站的表述与此一致，此处不逐一外链）
当前帮助中心口径：一个商品最多上传 20 张照片和 1–2 条视频。 空着的图位是浪费的点击机会；我们体检里会提示「还有几个空位」。
Current Help Center: up to 20 photos and 1–2 videos per listing. Empty slots are missed click opportunities.
出处 / Source： Etsy Help — Adding photos and video
官方与主流卖家指南常见推荐是 4:3（如 2700×2025）或 1:1 方形。 极端宽画幅在搜索缩略图里更容易被裁掉主体。我们把 4:3 与 1:1 都算「通过」。
Common official / seller guidance prefers 4:3 (e.g. 2700×2025) or 1:1. Extreme panoramas clip harder in search thumbs. We treat both 4:3 and 1:1 as pass.
出处 / Source： Etsy Help — listing photos； 卖家实践汇总（尺寸建议不一，取保守并集）
不是「画质差一点还能凑合看大图」。机制是：短边 < 2000px → 禁用 hover-zoom。 买家无法放大看材质/做工，会直接怀疑商品质量（对手作尤其致命）。
It is not “slightly softer zoom.” Short side < 2000px → hover-zoom is disabled. Buyers cannot inspect craft — a trust killer for handmade goods.
出处 / Source： Etsy Help — Adding photos and video （2000px 与 hover-zoom 的对应关系，多个第三方来源亦有引述；「买家因模糊而怀疑质量」属体验向论述）
商品页 DOM 常只给出 il_794xN 一类 CDN 尺寸。要得到真实上传原图，
需将 URL 换为 il_fullxfull。用浏览器「图片另存为」看到的尺寸，经常不是 Etsy 用来判 zoom 的那张。
Listing DOM often exposes il_794xN CDN URLs. True master size needs il_fullxfull.
“Save image as…” from the page often is not the file Etsy uses for zoom decisions.
出处 / Source：本项目对多个真实 listing 的 DOM 校准（见仓库 docs/etsy-dom-calibration-2-结论.md）
实验表明：请求 il_2000xN 往往总是返回 2000 边；
il_4000xN 甚至可能超原图放大。因此不能用「指定尺寸 URL 返回了多大」来判定你上传的原图够不够。
必须以 il_fullxfull（或本地文件）为准。
il_2000xN often always returns a 2000 edge; il_4000xN can even upscale past the master.
Never infer upload quality from a sized CDN URL — use il_fullxfull or your local file.
出处 / Source：本项目尺寸推导实验（docs/需求清单-交付Cursor.md 校准节）
PNG/WebP 透明通道在 Etsy 前台常被填成黑色，商品像扣在黑底上。 重传前请先铺白/米色实底，再导出 JPEG。
Transparent PNG/WebP alpha is often filled as black on Etsy. Flatten onto a light solid background, then export JPEG.
出处 / Source：卖家社区与工具实践共识；本产品重传配方默认写明「不要透明背景」
打开别人的 listing 时，页面上不会完整展示卖家后台那 13 个标签。 竞品若声称「粘贴链接就能读全标签」，要么在越权抓取，要么做不到。 合法路径是：你自己打开的页面 + 官方 API（仅公开字段）/ 或卖家本人在 Shop Manager。
Public listing pages do not show the seller’s full 13-tag set. “Paste a link to read all tags” is either scraping or vaporware. Legitimate paths: on-page public fields + official API, or the seller’s own Shop Manager.
出处 / Source：Etsy Open API 字段范围；本项目网页版可行性分析（公开页反爬 / 403）
各来源推荐尺寸并不统一（2700×2025 / 2700×2700 / 2000×2000…）。 我们采用保守并集：目标 2700×2025（4:3），JPEG 约 85%，<1MB，sRGB， 无透明、首图无大段文字/水印/花边 —— 同时满足 ≥2000 放大与 ≥635 首图。
Published size tips disagree. Our conservative target: 2700×2025 (4:3), JPEG ~85%, <1MB, sRGB, no alpha, clean hero — clears both the 2000 zoom floor and the 635 first-photo floor.
出处 / Source：帮助中心图片要求 + 多来源尺寸建议并集；产品内「重传配方」文案