· 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.
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.
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.
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.
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.
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.
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.
Dark-mode Etsy apps can exaggerate gray fringes around hairline anti-aliasing. Flattening with a one-pixel matting color reduces halos.
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.
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.
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.
Batch flatten with actions in Photoshop or affinity macros. Record background color, flatten, export sRGB, run through TagPeek, paste recipe into the action notes.
Canva users: toggle background color before download. Transparent download is the default for some templates unless you set a backdrop.
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.
If black backgrounds are intentional brand style, verify contrast on both light and dark UI shells Etsy uses in different contexts.
GIF and animated assets follow different rules; this note focuses on static heroes Etsy repeats in search.
Watermarks plus transparency double visual noise. Rule notes on watermarks apply even when alpha looks fine in admin.
Re-audit after Etsy image processing when you change only background color. CDN refresh can lag; private-window checks reduce false panic.
TagPeek does not upload your PNG for remote analysis. Local reads keep staging files on your machine — important when art is unreleased.
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.
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.
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.
Seasonal PNG badges on heroes should flatten with the photo, not float as separate transparent overlays clipped in crops.
Link fixes back to Rule 08 and the photo checker feature page for live verification after upload.
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.
Transparency problems feel like platform bugs; most are fixable export choices verifiable in ten seconds locally before publish.
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.
Patterned paper backgrounds photograph better than simulated transparency for flat lay shops. You gain texture without alpha surprises in search.
When teaching flatten fixes in courses, link students to Rule 08 instead of retyping guidance that drifts from Etsy Help wording.
TagPeek listing health includes photo self-checks alongside transparency notes so one extension pass covers both pixel floors and display risk.
（正文为英文；切换中文可查看导航与页脚。）