· TagPeek
· TagPeek
Transparent PNGs render black on Etsy — here's the fix
透明 PNG 在 Etsy 上发黑 —— 这样修
Transparent PNGs look perfect in Photoshop and turn charcoal gray — or outright black — on Etsy search grids. The issue is not mystery compression alone; it is how alpha channels interact with Etsy’s image pipeline and the backgrounds buyers see in dark-mode browsers.
透明 PNG 在 Photoshop 里完美，到了 Etsy 搜索网格却变成炭灰——甚至纯黑。问题不只是神秘压缩；更是 alpha 通道如何与 Etsy 的图片流水线、以及买家在深色模式浏览器里看到的背景交互。
Rule 08 in TagPeek’s rules library documents transparent background guidance and our re-upload recipe defaulting to opaque product photos for predictable display. Sellers exporting logos, stickers, or digital mockups on clear backgrounds hit this most often.
TagPeek 规则库的规则 08 记录了透明背景指引，我们的重新上传配方默认用不透明商品图以保证显示可预期。导出 logo、贴纸或数字样机且背景透明的卖家，最常踩到这一点。
Alpha transparency assumes a compositor will blend edges against a chosen backdrop. Etsy category tiles and mobile search cards do not guarantee white behind your art. Semi-transparent pixels that looked soft on checkered canvases collapse against dark UI chrome.
Alpha 透明假定合成器会把边缘与选定背景混合。Etsy 的类目瓷片与手机搜索卡片，并不保证你的作品背后一定是白底。在棋盘格画布上看起来柔和的半透明像素，撞上深色 UI 边框就会塌掉。
The fix is boring and reliable: flatten to a solid background that matches your shop aesthetic — usually white or light neutral for product catalog consistency. Export JPEG at high quality for photographic items; PNG remains fine when transparency is truly required, but expect to test on the live listing.
修复办法无聊但可靠：压平到与店铺审美一致的实心背景——商品目录通常用白或浅中性色以求一致。摄影商品用高质量 JPEG；确需透明时 PNG 仍可用，但务必在 live listing 上实测。
TagPeek’s local detector flags transparency as a self-check so you catch alpha before upload. Combine with crop previews to ensure flattened backgrounds still place the product inside safe zones for square grids.
TagPeek 本地检测会把透明标为自检项，帮你在上传前抓住 alpha。再配合裁切预览，确认压平后的背景仍把商品放进方形网格的安全区。
Sticker shops sometimes keep transparency for die-cut previews. If search heroes use transparency, verify on desktop and mobile listing views, not only in admin thumbnails.
贴纸店有时为刀模预览保留透明。若搜索主图使用透明，请在桌面与手机 listing 视图核实，不要只看后台缩略图。
Print-on-demand mockups with fake shadows on transparent PNGs often fail buyer trust even when backgrounds render correctly. Flattened natural shadows on opaque backgrounds usually read better at thumbnail scale.
按需印刷样机若把假阴影做在透明 PNG 上，即便背景渲染正确，也常损害买家信任。不透明背景上的自然阴影，在缩略图尺度通常更好读。
Dark-mode Etsy apps can exaggerate gray fringes around hairline anti-aliasing. Flattening with a one-pixel matting color reduces halos.
深色模式的 Etsy App 会夸大发丝级抗锯齿周围的灰边。用一像素的垫底色压平，可减轻光晕。
Do not confuse transparency issues with the 794px preview trap. Right-click saves can be both small and flattened wrong. Measure your export file locally.
别把透明问题与 794px 预览陷阱混为一谈。右键另存可能既小、又压平错误。请在本地测量你的导出文件。
Hover-zoom still applies to flattened JPEGs if the short side clears the published floor near 2000px. Transparency fixes display; pixels still gate zoom separately per Rule 01.
压平后的 JPEG 只要最短边达到公开的近 2000px 下限，hover-zoom 仍然适用。透明修复的是显示；像素是否过关仍按规则 01 单独卡放大。
First-photo 635px floors apply to flattened files too. A tiny transparent logo upscaled onto a large canvas passes dimensions while failing the squint test — crop tighter before flattening.
首图 635px 下限同样适用于压平文件。把很小的透明 logo 放大贴到大画布上，可能过尺寸关却过不了眯眼测试——压平前先裁紧一点。
Batch flatten with actions in Photoshop or affinity macros. Record background color, flatten, export sRGB, run through TagPeek, paste recipe into the action notes.
用 Photoshop Action 或 Affinity 宏批量压平。记录背景色、压平、导出 sRGB，跑 TagPeek，把配方贴进 Action 备注。
Canva users: toggle background color before download. Transparent download is the default for some templates unless you set a backdrop.
Canva 用户：下载前打开背景色。部分模板默认透明下载，除非你设了衬底。
Digital download listings showing transparent mockups in hero slots should still test buyer-facing tiles. Buyers judge files from the still hero, not the ZIP contents.
数字下载 listing 即使 ZIP 里是透明样机，主图槽仍应测试买家端瓷片。买家根据静态主图判断，而不是压缩包内容。
If black backgrounds are intentional brand style, verify contrast on both light and dark UI shells Etsy uses in different contexts.
若黑底是刻意的品牌风格，请在 Etsy 不同场景使用的浅色与深色 UI 外壳上都核实对比度。
GIF and animated assets follow different rules; this note focuses on static heroes Etsy repeats in search.
GIF 与动态资源规则不同；本篇聚焦 Etsy 在搜索中重复使用的静态主图。
Watermarks plus transparency double visual noise. Rule notes on watermarks apply even when alpha looks fine in admin.
水印加上透明会加倍视觉噪音。即便 alpha 在后台看起来正常，规则说明里关于水印的提醒仍然适用。
Re-audit after Etsy image processing when you change only background color. CDN refresh can lag; private-window checks reduce false panic.
只改背景色后，等 Etsy 图片处理完成再复审。CDN 刷新可能滞后；用无痕窗口检查可减少虚惊。
TagPeek does not upload your PNG for remote analysis. Local reads keep staging files on your machine — important when art is unreleased.
TagPeek 不会把你的 PNG 上传做远端分析。本地读取让未发布的作品留在你的机器上——对未公开稿件很重要。
Compare flattened heroes with competitors in the same query at card size. You are calibrating readability, not copying style.
在同一查询下，以卡片尺寸对比竞品压平后的主图。你在校准可读性，不是抄风格。
International teams: color names in attributes should match the flattened background hue families buyers filter on.
跨国团队：attributes 里的颜色名，应与压平背景所属的色系一致，方便买家按色筛选。
When black renders only on mobile, suspect dark-mode compositing before re-exporting twice at wrong dimensions.
若只在手机发黑，先怀疑深色模式合成，再别急着以错误尺寸连导两次。
Vector sources should rasterize at sufficient resolution before flattening. Crisp vectors on infinite canvases shrink poorly in grids.
矢量源应在压平前以足够分辨率栅格化。无限画布上的锐利矢量，缩进网格时往往很差。
Keep a flattened finals folder separate from layered masters. Future edits need layers; Etsy needs predictable pixels.
把压平终稿文件夹与分层原稿分开。未来编辑需要图层；Etsy 需要可预期的像素。
If flattening fixes display but zoom stays off, return to shortest-side measurement — two independent checks.
若压平修好了显示但放大仍关，回到最短边测量——这是两项独立检查。
Educate photographers to deliver both layered and web-flat exports. TagPeek validates the web-flat destined for slot one.
请摄影师同时交付分层稿与网页压平导出。TagPeek 校验的是准备放进第一槽的网页压平版。
Seasonal PNG badges on heroes should flatten with the photo, not float as separate transparent overlays clipped in crops.
主图上的季节性 PNG 徽章应与照片一起压平，而不是作为单独透明层漂浮、在裁切中被裁掉。
Link fixes back to Rule 08 and the photo checker feature page for live verification after upload.
把修复链回规则 08 与图片检查功能页，以便上传后做线上核实。
Avoid semi-transparent white boxes behind text on heroes. They become muddy gray on dark backgrounds.
避免在主图文字后叠半透明白框。它们在深色背景上会变成浑浊的灰。
Document flatten color in your shop wiki next to JPEG quality numbers from the detector recipe.
把压平用色写进店铺 wiki，放在检测器配方给出的 JPEG 质量数字旁边。
Transparency problems feel like platform bugs; most are fixable export choices verifiable in ten seconds locally before you publish.
透明问题常被当成平台 bug；多数其实是可在发布前本地十秒核实的导出选择。
Clipping masks in design tools can hide checkered backgrounds until export. Expand the canvas before flattening so anti-aliased edges retain enough matting pixels.
设计工具里的剪切蒙版可能在导出前藏住棋盘格背景。压平前扩大画布，让抗锯齿边缘保留足够垫底像素。
Night-mode phone screenshots of your listing are a useful QA step after flattening. If edges look crunchy, re-export with a slightly lighter matting color.
压平后用手机夜间模式截图 listing，是有用的 QA。边缘发硬就换稍浅的垫底色再导一次。
Patterned paper backgrounds photograph better than simulated transparency for flat lay shops. You gain texture without alpha surprises in search.
对平铺摄影店铺，真实纹理纸背景往往比模拟透明更好拍。你得到质感，又避开搜索里的 alpha 意外。
When teaching flatten fixes in courses, link students to Rule 08 instead of retyping guidance that drifts from Etsy Help wording.
在课程里教压平修复时，把学员链到规则 08，而不是手抄一份会逐渐偏离 Etsy Help 措辞的说明。
TagPeek listing health includes photo self-checks alongside transparency notes so one extension pass covers both pixel floors and display risk.
TagPeek 的 listing 健康分把照片自检与透明提示放在一起，一次扩展通过即可覆盖像素下限与显示风险。