WooCommerce Category Thumbnails Are Missing Alt Text

WooCommerce category thumbnail alt text is the gap that survives every product-level audit you run. You fix alt text on product photos, clear the gallery images, sort out the variations — and the shop page still has empty alt attributes on every one of those neat little category tiles sitting above the product grid: "Rings", "Candles", "Outdoor Furniture", each with its own thumbnail and none of them described.

That's because category thumbnails aren't product images at all. They live on a taxonomy term, not a product, so none of the tools built to scan products ever look at them. This post explains why category and archive thumbnails get missed, what alt text for a category image should actually say, and how to close the gap across your whole shop without editing product after product.

Why category thumbnails escape your alt text

WooCommerce product categories are just taxonomy terms — the same underlying WordPress structure as a blog category or tag. When you add a thumbnail to a category (Products → Categories → edit a category → Thumbnail), WooCommerce stores that image as a term meta value pointing to a Media Library attachment. It displays on your shop page, on archive pages, sometimes in a category-grid block on the homepage.

That single structural fact is why it slips through. Alt text audits and bulk-fix tools are almost always written around products: they loop through post_type=product, check the featured image, check the gallery, maybe check variations. A category thumbnail isn't attached to a product post at all — it's attached to a product_cat term — so a scan that only walks products never visits it. The image can go completely untouched indefinitely, and the count of "products with alt text" will look perfectly healthy while every category tile above those products stays blank.

It compounds because category thumbnails are usually uploaded once, early, when the shop was set up, often by whoever built the theme rather than whoever manages the catalogue day to day. Nobody revisits them. And unlike a product photo, which a customer studies before buying, a category thumbnail is glanced at for half a second while browsing — easy to assume it doesn't matter. It does: these are exactly the generic, high-traffic image URLs (/shop/, /product-category/rings/) that Google Images crawls repeatedly, and they're the first image a screen reader announces on a page that's meant to help someone navigate your whole catalogue.

On a shop with thirty categories, that's thirty images carrying zero descriptive text on some of the most-viewed pages of the entire site — the shop landing page and every archive beneath it.

What good alt text for a category thumbnail actually says

A category thumbnail alt text has a different job to a product photo's alt text. It isn't describing one item for sale; it's describing what a shopper will find if they click through. Think of it as a signpost, not a product description.

The reliable pattern is what the category contains + a distinguishing visual detail, kept short:

• "Handmade silver rings displayed on a wooden tray" — not "rings", and not "click here for rings".
• "Assorted scented candles in amber glass jars" — not "candle category".
• "Outdoor teak furniture set on a garden patio" — not "furniture".

Avoid two habits that undermine the point. First, don't reuse the category name verbatim as the entire alt text ("Rings" as the alt text for the rings thumbnail) — it passes an automated check but tells Google Images and a screen reader nothing the link text didn't already say. Second, don't write it as a call to action ("Shop our ring collection now!") — alt text describes the image, it isn't ad copy, and stuffing it with marketing language reads as spam to both search engines and assistive technology users.

Keep each one under about 125 characters and specific enough that it would still make sense if the image appeared alone in a Google Images results grid, disconnected from your site's navigation.

How to fix WooCommerce category thumbnail alt text

1. List your categories. Go to Products → Categories. Every row with a thumbnail set is a candidate — sort by count if you want to prioritise your highest-traffic categories first.
2. Open a category and find its thumbnail. Edit the category, scroll to the Thumbnail panel, and click through to view the attachment in the Media Library. This is the same attachment screen you'd use for a product image.
3. Check the Alternative Text field. On most stores it's empty, even on categories that have been live for years — this is the gap the audit above explains.
4. Write it using the pattern above. Lead with what the category contains, add one concrete visual detail, skip "image of" and skip sales language.
5. Work through every category, not just the visible ones. Don't stop at the categories shown on your homepage grid — sub-categories and rarely-linked archive terms carry thumbnails too, and they're just as invisible to a taxonomy-blind audit.
6. Check archive-level images separately from products. If you're running a broader alt text audit, confirm it explicitly scans product_cat term thumbnails rather than only product posts — otherwise this exact gap reappears every time. Our free image SEO audit checks both, so you can see category-level gaps alongside product-level ones in one pass.
7. Use a tool that covers taxonomy images for larger catalogues. Hand-editing thirty or forty category thumbnails is a manageable afternoon; on a multi-brand or multi-locale store with hundreds of categories it isn't. The OpptiAI Alt Text plugin scans category and tag thumbnails alongside product images, so taxonomy archives stop being the part of the store nobody checks.

Once you've been through the list, open the shop page in an incognito window and step through a screen reader (or just view source and search for product_cat thumbnail img tags) to confirm every tile now carries a real description, not a blank attribute.

Frequently asked questions

Does a WooCommerce category thumbnail need alt text if the category name is already a link?

Yes, and for a specific reason: the link text and the image alt text serve different purposes. A screen reader announces the image separately from the surrounding link, so a blank alt attribute is still a blank alt attribute even when the category name sits right next to it as clickable text. For SEO, Google Images indexes the alt attribute on the image itself — it doesn't borrow the anchor text of a nearby link to fill the gap. Treat the thumbnail as its own image that needs its own description, regardless of what text sits beside it.

Why doesn't my alt text plugin catch missing category thumbnails?

Most alt text tools, including many bulk generators, are built around WooCommerce products specifically — they loop through product posts, checking featured images, galleries, and sometimes variations. A category thumbnail isn't attached to a product; it's stored as thumbnail meta on a product_cat taxonomy term, a structurally different part of WordPress. A tool that only queries products has no reason to ever load a term's thumbnail attachment, so it reports your catalogue as fully covered while every category and sub-category tile stays blank. Confirm any audit or generator you use explicitly mentions scanning taxonomy or archive images, not just product images.

Should WooCommerce category thumbnail alt text include keywords?

It should include the natural, specific words a shopper would use to describe what's in that category — not stuffed keyword phrases. "Handmade silver rings on a wooden tray" naturally contains the terms someone searching Google Images for silver rings would use, without reading as manipulative. Avoid stacking synonyms or repeating the category name multiple times in one alt attribute; that pattern is easy for both search engines and screen reader users to spot as filler, and it doesn't improve ranking. One accurate, specific sentence beats a list of keywords every time.

Fix the tiles nobody checks

Category thumbnails sit on some of the highest-traffic pages in a WooCommerce store — the shop page, every archive beneath it — and they're routinely invisible to alt text audits because they live on a taxonomy term, not a product. The fix doesn't require touching a single product: work through Products → Categories, describe what each thumbnail shows, and confirm whatever tool you rely on actually scans term thumbnails rather than assuming products cover everything.

If you want to see how many category and product images are missing alt text before deciding how to tackle it, run the free image SEO audit — it checks taxonomy thumbnails alongside product photos. When you're ready to fix them at scale, the OpptiAI Alt Text plugin covers category and tag images too, so the pages that introduce shoppers to your catalogue stop being the blind spot.