Display WooCommerce Categories with Thumbnails

Quick Summary
- Inside a ul in a theme template, a get_terms loop over product_cat shows each non-empty product category's thumbnail linked to its archive.
- The image URL comes from the category's thumbnail_id meta via wp_get_attachment_thumb_url, and get_category_link builds each archive link.
- get_woocommerce_term_meta is deprecated, so use get_term_meta with the same three arguments to avoid the deprecation notice.
This loop displays WooCommerce categories with thumbnails, each category image linked to its category page. It’s handy for a custom homepage section or a shop landing page that shows categories as image tiles. WooCommerce must be active, and the image is the one you set in the Thumbnail field when you edit a product category.
Add the code to the theme template file where the list should appear, preferably in a child theme. It outputs <li> items, so place it inside a <ul> element.
<?php
$prod_categories = get_terms( 'product_cat', array(
'orderby' => 'name',
'order' => 'ASC',
'hide_empty' => 1
));
foreach( $prod_categories as $prod_cat ) :
$cat_thumb_id = get_woocommerce_term_meta( $prod_cat->term_id, 'thumbnail_id', true );
$cat_thumb_url = wp_get_attachment_thumb_url( $cat_thumb_id );
?>
<li>
<a href="<?php echo get_category_link( $prod_cat->term_id ); ?>">
<img src="<?php echo $cat_thumb_url; ?>" alt="<?php echo $prod_cat->name; ?>" />
</a>
</li>
<?php endforeach; wp_reset_query(); ?>How it works
get_terms()fetches the terms of theproduct_cattaxonomy, sorted by name from A to Z.hide_emptyset to1skips categories that have no products.get_woocommerce_term_meta()reads the category’sthumbnail_id, the attachment ID of its image.wp_get_attachment_thumb_url()turns that ID into the URL of the thumbnail-size image. For a larger image, see changing the category thumbnail size.get_category_link()builds the link to the category archive. It works here because it looks the term up by its ID;get_term_link( $prod_cat )is the more direct choice for a product category.
Things to watch
get_woocommerce_term_meta()is deprecated in current WooCommerce.get_term_meta()with the same three arguments returns the same value without the deprecation notice.- A category without an image gets an empty
src, so you may want to skip those or show a placeholder image. - For safer output, wrap the URLs in
esc_url()and the category name inesc_attr().
For a category layout designed and built into your store theme, see my WooCommerce development services.
Related articles
- hiding selected product categories with an ACF field: leave some categories out of a list like this one
- listing one category’s products by ID: show a single category’s products in a custom template
