Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

WooCommerce · Guide

How to Edit a WooCommerce Product Category Page (Text, Image, Layout and SEO)

How to Edit a WooCommerce Product Category Page (Text, Image, Layout and SEO)

Short answer

To edit a WooCommerce product category page, go to Products > Categories, click Edit on the category, and change its name, slug, description, display type and thumbnail. To change the page layout, edit the Products by Category template in Appearance > Editor in a block theme, or use your theme options or a page builder's archive template in a classic theme.

Key takeaways

  • Category text, image and display type live under Products > Categories.
  • The description usually appears at the top of the category page.
  • Block themes control category layout with the Products by Category template.
  • Classic themes use theme options, the Customizer or a page builder.
  • Unique descriptions and clear subcategories help shoppers and SEO.

What is a WooCommerce product category page?

It is the archive page that lists all products in one category, such as Shoes or Gift cards, with its own URL, title, description, optional image and subcategories.

Category pages are often the main entry points from search engines and menus, so they deserve as much care as product pages.

They also act as landing pages for ads and email campaigns, so a clear heading and introduction pay off across marketing channels.

The WooCommerce documentation on managing product categories, tags and attributes explains every category setting.

Our guide on customizing WooCommerce pages covers the shop and other store pages too.

How do you edit category text and images?

Go to Products > Categories, hover over the category and click Edit, then change the name, slug, parent, description, display type and thumbnail, and click Update.

The name is the page heading in most themes. Keep it short and clear.

Use the words shoppers search for. Dresses works better than a clever internal name like Summer Collection 3.

Changing the slug changes the URL. Add a redirect if the old category page had traffic.

The thumbnail appears when categories are shown as tiles, such as on the shop page or parent category pages.

Use the same image size and style for every category thumbnail, so tiles line up neatly.

How do you write a good category description?

Write a short, useful introduction that tells shoppers what the category includes and helps them choose, rather than a long block of keyword-stuffed text.

Two or three short paragraphs above the products usually work well.

Write for people first. A sentence that helps someone choose is worth more than a paragraph of keywords.

Mention buying help, such as sizing, materials or how to pick between types.

Update descriptions when the range changes. Old text that mentions discontinued items confuses shoppers.

Some themes show the description below the products as well. Check where your theme places it before writing a long text.

Yes. The description field accepts basic HTML, so you can add links to buying guides or related categories, but keep it readable on mobile.

Link one or two helpful guides at most. Too many links distract from the products.

What does display type do?

Display type sets what the category page shows: products only, subcategories only, both, or the theme's default, which matters for parent categories with children.

Display typeWhat shoppers seeBest for
DefaultFollows the shop settingMost categories
ProductsProduct grid onlyCategories without children
SubcategoriesCategory tiles onlyLarge parent categories
BothTiles above productsMid-sized parent categories

Subcategory tiles help shoppers narrow down big catalogs quickly.

Avoid more than two or three levels of subcategories. Deep trees make products harder to find.

Use clear thumbnails for subcategories. Tiles without images look unfinished.

How do you show category images on the category page itself?

Many themes only show the thumbnail in category tiles, so to show it as a banner on the category page, add a Term image or Cover block to the template, or use a theme option if one exists.

A banner works well for seasonal or brand categories. Keep it short so products still appear near the top of the screen.

How do you change the layout in a block theme?

Go to Appearance > Editor > Templates, open Products by Category, and edit its blocks: the heading, description, product collection, sorting, filters and pagination.

Changes to this template affect every category page, so test a few categories after editing it.

Add a banner image or short promotion above the products with a Cover block if a category needs extra context.

The WordPress documentation for the Site Editor explains how to edit and reset templates.

You can create a custom template for one category, for example a seasonal collection, and keep the default for the rest.

Custom templates are useful for gift guides or sale categories that need a special introduction or layout.

How do you change the layout in a classic theme?

Use the Customizer's WooCommerce section for products per row and category display, your theme's store options for sidebars and headers, or a page builder's archive template.

Many store themes offer a shop sidebar with filters. Turn it on for category pages with many products.

Check that the category heading and description still show when you switch layouts, since some layouts hide them.

If you use Elementor Pro, its theme builder can design product archive templates with conditions for specific categories.

Our guide on using Elementor templates covers theme builder templates.

How do you add filters to category pages?

Add WooCommerce filter blocks, such as price, attribute, stock and rating filters, to the category template, so shoppers can narrow down products without leaving the page.

Filters matter most in categories with many similar products, such as clothing sizes or colours.

Attributes such as size and colour must be set up as global attributes for attribute filters to work.

Keep filters relevant. Showing filters that apply to only one product wastes space.

Show the number of matching products next to each filter option if your theme supports it, so shoppers avoid dead ends.

Test filters on mobile, where they usually collapse into a button.

How do you change the product order on a category page?

Category pages use your store's default sorting, so set it in the Customizer or drag products into a manual order; per-category orders need a sorting plugin.

Our guide on changing product order in WooCommerce covers each method.

Put best sellers or new arrivals first in key categories.

Review the first row of each important category every few months. Seasonal products may need to move up or down.

How do you improve category page SEO?

Give each category a unique title, meta description and introduction, link related categories, keep URLs short, and make sure the page loads quickly with optimised images.

SEO plugins add title and description fields to the category edit screen.

Breadcrumbs help both shoppers and search engines understand where a category sits in the store. Many themes and SEO plugins can show them.

Google's guide to ecommerce site structure explains how category pages help search engines understand a store.

Our guide on handling category and tag pages for SEO covers indexing decisions for thin categories.

How do you speed up category pages?

Show a sensible number of products per page, compress product images, avoid heavy sliders above the grid, and use caching that safely handles store pages.

The first row of product images often decides loading speed. Google's guide to optimizing Largest Contentful Paint explains why.

Lazy loading for images further down the page keeps the first view fast.

Products per page also affects speed. Twelve to twenty-four products is a common balance between choice and loading time.

How do you reorganise categories?

Plan a simple hierarchy with a few top-level categories and clear subcategories, move products into place, then delete or merge unused categories with redirects.

Assign products to the most specific category that fits, and to a parent only if it helps navigation.

Products can belong to several categories, which helps when the same item fits two shopping paths.

The category structure in WooCommerce works like post categories. Our guide on adding categories in WordPress explains hierarchy basics.

What mistakes should you avoid?

Avoid empty categories, duplicate descriptions copied across categories, very long text that pushes products off screen, and categories with only one product.

Hide or remove empty categories from menus until they have products.

Write category descriptions in your own words. Copying supplier text across many stores gives search engines little reason to prefer your page.

Check category pages after theme or plugin updates. Template changes can move or hide descriptions.

Look at each important category on a phone at least once a month. Mobile layouts are where descriptions and filters break most often.

Frequently asked questions

How do I edit a product category page in WooCommerce?

Go to Products, then Categories, and click Edit on the category to change its name, description, image and display type. Edit the layout in the Site Editor or your theme options.

Where does the category description appear?

Most themes show it at the top of the category page, above the products. Some themes also or instead show it below the product grid.

How do I add an image to a product category?

Edit the category under Products, then Categories, and use the Thumbnail field to upload or choose an image, then click Update.

How do I change the layout of all category pages?

In a block theme, edit the Products by Category template in Appearance, then Editor. In a classic theme, use theme options or a page builder archive template.

Should category pages have text for SEO?

Yes, a short unique introduction helps shoppers and search engines. Keep it helpful and avoid long keyword-stuffed text that pushes products down.

Sources

  1. Managing product categories, tags and attributes WooCommerce Docs
  2. Site Editor WordPress.org Documentation
  3. Help Google understand your ecommerce site structure Google Search Central
  4. Optimize Largest Contentful Paint web.dev

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.