Custom Product Tag Image lets merchants attach images to WooCommerce product tags and renders them as visual badges on product cards and single product pages. New, Sale, Limited Edition, Vegan, Eco-friendly — any tag becomes a recognisable visual signal across the catalog.
I built this as a quietly powerful merchandising tool that holds a perfect 5.0-star rating on the official WooCommerce Marketplace. Tag-driven badges scale better than per-product badge configuration because a single tag image is enough to flag every product wearing that tag.
The problem it solves
Visual merchandising matters. A New badge sells different items than a Sale badge, but configuring badges per product is operationally exhausting. WooCommerce ships with tags as a taxonomy but no native way to attach imagery to them — which leaves merchants either editing individual products or living without visual badges.
The plugin gives merchants a one-time tag-image setup that automatically flags every product carrying that tag.
What the plugin does
A clean tag-to-badge rendering layer for WooCommerce catalogs:
- Attach image to any product tag — one image per tag, applied to every product that carries it
- Renders on product cards — shop, archive and category page tiles all show the badge
- Renders on single product pages — badges appear alongside the product gallery
- Position control — choose where the badge sits on the product image
- Multiple badges per product — products with multiple tags show multiple badges
- Responsive scaling — badges scale appropriately across breakpoints
- Theme-compatible — uses standard product loop hooks, no template forks
- No per-product configuration needed — set tag image once, every tagged product inherits
How it is built
Tag images are stored as term meta against the WooCommerce product_tag taxonomy, with a tag-edit screen extension that lets merchants upload imagery from the WordPress media library. Rendering hooks into woocommerce_before_shop_loop_item_title for catalog tiles and the single-product image hook for product pages, so badges layer cleanly on top of the existing imagery without forking templates. The query layer caches tag-image lookups so badge rendering does not introduce per-tile database hits.
The plugin is HPOS-compatible at the order layer, fully translatable, and works with all major WooCommerce themes without modification.
Marketplace adoption
A perfect 5.0-star rating across 10 reviews on the official WooCommerce Marketplace is the cleanest possible signal that the plugin does exactly what merchants want. The customer base is merchandising-focused — stores where visual signals on product tiles directly affect click-through and conversion.
- Marketplace rating: 5.0 stars — based on 10 customer reviews on the official WooCommerce Marketplace, a perfect score
- Active merchandising customer base — used by stores where visual badging drives discovery
- Theme-compatible by default — composes with standard loop hooks
- One-time setup, store-wide effect — tag image set once, every tagged product inherits
- Multi-year tenure on the marketplace — continuously maintained through WooCommerce releases
Need a custom WooCommerce plugin built like this?
I build production-grade WooCommerce plugins like the ones I shipped on the official WooCommerce Marketplace — focused tools that scale across the whole catalog from a single configuration. If you need custom merchandising or catalog-display logic, let’s talk.
See my WooCommerce plugin development service