WooCommerce Product Bundles: The Alt Text Gap

Run an alt text audit across a WooCommerce store that sells bundles, and the bundle thumbnails are often the only images that come back blank. Not because anyone forgot them — because most bulk alt text tools, and more than a few store owners' own checklists, loop over the product post type and stop there. A Bundle (from WooCommerce Product Bundles) or a Mix and Match product isn't a plain product under the hood; it's a composite that carries its own container image on top of the images already attached to every item inside it, and that container image is exactly the one shoppers see first on the shop page and in Google Images.

This matters more than it looks like it should. Bundles and kits are usually a store's higher-margin, higher-AOV listings — gift sets, starter kits, "buy the trio" offers — which means the pages Google Images sends the least accessible traffic to are often the ones worth the most per visit.

Why bundle images slip past normal alt text fixes

A standard WooCommerce product has one featured image and a gallery, both attached to a post of type product. Product Bundles and Mix and Match add a layer on top of that:

• The bundle itself is still a product post, so its featured image usually does get picked up by a bulk tool — but only if the plugin set a featured image at all. Many bundles are created by cloning a simple product and never get a dedicated hero shot, so they inherit a generic placeholder with no alt text anywhere in the chain.
• Each bundled item is a reference to an existing product, and its thumbnail on the bundle's own page is often pulled through a shortcode or a bundle-specific template partial, not through the standard wp_get_attachment_image() call your alt text plugin hooks into. If the theme or the bundle template renders that thumbnail with a raw <img src> and no alt attribute passed through, no plugin can inject one after the fact without a specific integration for that template.
• Mix and Match products render their whole grid of selectable items through a dedicated WooCommerce template (mix-and-match/), which frequently bypasses the attachment's stored alt text entirely and falls back to the product title, or nothing.
• Variation swatches inside a bundle (pick your size, pick your colour, for each bundled item) nest one more level deep, so even a theme that gets the bundle's main image right can still drop alt text on the per-item variation thumbnails.

The result is a store where the alt text audit says "98% coverage" at the product level, while the actual bundle landing pages — the ones ranking for "gift set" and "starter kit" searches — serve images with no alt text a screen reader or Google Images crawler can read.

How to check your own store

1. Pull a list of bundle and Mix and Match products specifically, not just all products. In WooCommerce admin, filter Products by Product type → Bundle (or Mix and Match if you run that extension). Don't rely on a general "missing alt text" report to surface these — it only sees what it's told to look at.
2. Open three or four bundle pages in an incognito window and use your browser's inspector (right-click an image → Inspect) to check the actual rendered alt="" attribute on the container image and on each child item thumbnail. Don't trust the Media Library entry for that attachment — if the template doesn't pass the attribute through, the Library can show a perfectly good alt text value that never reaches the page.
3. Check the container image's attachment in Media Library. If it was auto-cloned when the bundle was created, it may be sharing an attachment ID with the parent simple product and carrying that product's (possibly also missing) alt text, not anything bundle-specific.
4. Set bundle-specific alt text, not a copy of the component product's text. "Weekend Starter Kit — cleanser, moisturiser, and SPF bundled together" describes the bundle; reusing "Hydrating Moisturiser 50ml" on the bundle thumbnail describes the wrong thing to both a screen reader user and Google Images.
5. Spot-check after any theme or bundle-plugin update. Template overrides for Bundles and Mix and Match are a common target for child-theme customisation, and a well-meaning template tweak can quietly drop the alt attribute that used to be there.

There's a knock-on effect worth knowing about too. If you sync bundles to Google Merchant Center for Shopping ads, the feed usually pulls its image and title from the bundle's own featured image, not from its component products — so a blank alt text on that specific attachment doesn't touch your Shopping feed directly, but it does mean the one image doing double duty across your accessibility tree and your product feed is being described, if at all, by whatever text happened to carry over when the bundle was created. The practical fix is the same either way: check the bundle's own featured image and its alt text specifically, rather than assuming it inherited something usable from the products bundled inside it.

OpptiAI Alt Text scans attached images across post types, including bundle and Mix and Match container images, and flags gaps with a suggested, editable description you approve before it saves — rather than assuming every bundle thumbnail is "the same as the main product" and copying text that describes the wrong thing.

Frequently asked questions

Does WooCommerce Product Bundles support alt text natively?

It stores alt text the same way any WordPress attachment does — on the Media Library entry — but the bundle and Mix and Match front-end templates don't always render that attribute through to the page. Native support for storing alt text isn't the same as the theme actually outputting it, and the gap is almost always on the output side, not the data side.

Why does my bulk alt text tool say 100% coverage but bundle images are still blank in the browser?

Most bulk tools report coverage against the Media Library's stored alt text field, which can genuinely be filled in while the live template still fails to pass that attribute through to the rendered <img> tag. Checking coverage in your plugin's dashboard and checking the rendered HTML on the actual bundle page are two different tests, and only the second one tells you what a screen reader or Google's crawler actually sees.

Should a bundle's alt text just repeat the alt text of its component products?

No — describe the bundle as its own product. A shopper (and a screen reader, and Google Images) benefits from "Three-piece skincare starter set in travel-size bottles" far more than from the alt text of whichever component image happens to be set as the bundle's featured image, which usually describes only one item in the set.

If you sell bundles or kits on WooCommerce, it's worth a five-minute check on how those specific pages render before assuming your site-wide alt text coverage number tells the whole story. OpptiAI Alt Text scans across product types, including bundles, and the free image SEO audit will show you exactly which images on your store are missing alt text today.