Seo category description missing
Moderate effortFound on 74% of audited stores.
Write a 100–200 word description for every category page explaining what products it contains and who they are for, so Google can rank it for category-level keywords.
What it is
A category description is a short block of text — typically 100 to 200 words — placed on a collection, department, or category page that explains what products shoppers will find there and why those products are relevant to them. Think of it as an introduction to the aisle: "This is our range of waterproof hiking boots, designed for trail runners and weekend trekkers who need ankle support and grip in wet conditions." Without it, the page is essentially just a grid of product images with no written context for either visitors or search engines.
Why it matters
Category pages are among the highest-value pages on any ecommerce store — they target broad, high-volume keywords like "women's running shoes" or "organic skincare" that drive enormous organic traffic. Google needs readable, unique text to understand what a page is about and to decide whether it should rank for those terms. A category page with zero descriptive text gives Google nothing to work with, so it will rank product pages or competitors' category pages instead, costing you significant organic traffic and revenue. A well-written description also improves click-through rates by giving Google material to generate a useful search snippet, and it builds shopper confidence by immediately confirming they've landed in the right place.
How to fix it
- Identify all category (collection/department) pages on your store that have no description text — start with your highest-traffic or highest-revenue categories.
- Write a 100–200 word description for each category. Open with what the category contains, then describe who it's for, highlight key features or benefits, and end with a natural call to action (e.g., 'Browse the full range below'). Use the main keyword phrase your customers would search for (e.g., 'women's waterproof hiking boots') naturally in the first sentence.
- Avoid duplicating the same boilerplate text across multiple categories — each description must be unique to that category's products and audience.
- Place the description in a visible location on the page — either above the product grid (preferred for immediate context) or below it (common when you don't want it to push products down on mobile). Above-the-fold placement with a 'read more' toggle is a strong compromise.
- After publishing, paste the category URL into Google Search Console's URL Inspection tool and request indexing so Google picks up the new content promptly.
- Monitor Google Search Console over the following 4–8 weeks for impressions and clicks on category-level keywords to confirm the descriptions are having a positive effect.
Fix it on your platform
Pick your platform for the exact steps.
How to fix seo category description missing on Shopify
- In your Shopify admin, go to Products → Collections.
- Click the collection you want to edit.
- In the 'Description' field (a rich-text editor below the collection title), type or paste your 100–200 word category description.
- Use the toolbar to bold key phrases or add bullet points if appropriate — the formatting is rendered as HTML on the storefront.
- Click Save. The description is output by your theme using the {{ collection.description }} Liquid variable; most themes display it above or below the product grid automatically.
- If your theme does not display {{ collection.description }}, go to Online Store → Themes → Edit code → find your collection template (usually sections/collection-template.liquid or templates/collection.liquid) and add {{ collection.description }} in the desired location.
- Optionally, use a 'read more / show less' JavaScript toggle if you prefer the description to be collapsed on mobile — search the Shopify Theme Store for 'collapsible content' sections.
How to fix seo category description missing on Shopify Plus
- Follow the same steps as Shopify above — the Collections editor is identical in Shopify Plus.
- If you use a custom storefront (Hydrogen/Headless), query the collection.description field via the Storefront API and render it as HTML in your category template.
- For script-heavy customisations, use Shopify Plus's Launchpad or Scripts Editor only for pricing rules — the description field itself is managed in the standard admin Collections editor.
How to fix seo category description missing on WooCommerce
- In your WordPress admin, go to Products → Categories.
- Click Edit next to the category you want to update.
- In the 'Description' field (below the Slug field), type or paste your 100–200 word category description. This field supports basic HTML — you can add <strong> tags or <ul> lists.
- If you want a full visual editor here, install the 'WooCommerce Category Description WYSIWYG' plugin (free on WordPress.org) or use a page builder plugin that hooks into category descriptions.
- Click Update to save.
- WooCommerce passes this description to your theme via the woocommerce_archive_description hook. Most WooCommerce-compatible themes display it automatically above the product grid on the /product-category/[slug]/ page.
- If it doesn't appear, check your theme's archive template (woocommerce/archive-product.php) and confirm the hook is called, or use the Yoast SEO or Rank Math plugin to add supplemental category content fields.
How to fix seo category description missing on BigCommerce
- In your BigCommerce control panel, go to Products → Product Categories.
- Click Edit (pencil icon) next to the category you want to update.
- Scroll down to the 'Category Description' field — it uses a rich-text (WYSIWYG) editor. Write or paste your 100–200 word description here.
- Use the editor's formatting tools to bold your primary keyword or add a short bullet list of sub-categories if relevant.
- Click Save & Exit.
- The description is output in your Stencil theme via the {{category.description}} Handlebars helper, which most themes render above the product listing by default.
- If it doesn't display, open your Stencil theme files in Page Builder or the Theme Editor (Storefront → My Themes → Edit), locate templates/pages/category.html, and ensure {{category.description}} is present in the template.
How to fix seo category description missing on Adobe Commerce (Magento)
- In the Magento Admin Panel, go to Catalog → Categories.
- Select the category from the category tree on the left.
- Open the 'Content' section (click to expand).
- In the 'Description' field, use the WYSIWYG editor to write or paste your 100–200 word category description.
- Optionally use the 'Add CMS Block' option inside the content section to insert a pre-built block with richer formatted content.
- Click Save (or Save and Continue Edit).
- The description is rendered in the category.phtml template (Magento_Catalog module). It appears above the product grid by default in Luma and most themes. If your theme overrides this template, locate vendor/magento/module-catalog/view/frontend/templates/category/view/description.phtml and confirm it is called.
How to fix seo category description missing on Magento Open Source
- Follow the same steps as Adobe Commerce (Magento) above — the Catalog → Categories → Content → Description path is identical in Magento Open Source.
- After saving, run php bin/magento cache:flush from your server terminal to clear the full-page cache so the description appears immediately on the live site.
How to fix seo category description missing on Wix
- In the Wix Editor, open your Wix Stores dashboard and go to Catalog → Collections.
- Select the collection whose page you want to update.
- Wix does not have a native 'collection description' field like Shopify. Instead, open the Wix Editor, navigate to the Collection/Category page, click an existing Text element above or below the product gallery, and type your description there — or click '+ Add' → 'Text' to insert a new text block.
- Write your 100–200 word description in that text block. Position it above the product grid for best SEO impact.
- If you use Wix Studio, you can bind a Text element to a CMS Collection field for dynamic categories — go to the CMS panel, open your Products Collection, add a 'Description' text field, fill it in, and connect ('bind') a text element on the page to that field.
- Publish the site when done.
How to fix seo category description missing on Wix Studio
- In Wix Studio, go to the CMS panel and open the dataset connected to your category/collection pages.
- Add a rich-text or long-text field named 'Category Description' if one does not exist.
- Fill in the description for each category row in the CMS dataset.
- On your dynamic category page template in the Studio editor, add a Text element, click 'Connect to Data', and bind it to the 'Category Description' field.
- Position the text element above the product grid in the page layout.
- Publish the site.
How to fix seo category description missing on Squarespace
- In Squarespace, category pages in Commerce are filtered product pages, not standalone pages with a dedicated description field.
- The recommended approach is to add a Text Block at the top of your main Shop page (above the product grid) that describes the category — or to create separate Squarespace Pages for major categories and embed the product list filtered by category using a Products Block.
- To add a description to a full dedicated category page: go to Pages → (your Shop page) → Edit, click '+' at the top of the content area, choose 'Text', and type your 100–200 word description.
- For stores using the built-in category filter (sidebar/dropdown), consider adding category-specific descriptions to a Text Block that updates based on context, or use Squarespace's Announcement Bar or intro section for the most prominent category text.
- Save and publish.
How to fix seo category description missing on Webflow
- In the Webflow Designer, open your Ecommerce → Categories CMS collection.
- Add a new Rich Text or Plain Text field called 'Description' to the Category collection schema (Collections → Categories → Add Field).
- Go to each category item in the CMS editor and fill in the 100–200 word description.
- Open your Category Template page in the Designer (found under Ecommerce → Category Template).
- Drag a Rich Text element (or Text Block) onto the canvas in the desired position (above the product list is recommended).
- Connect it to the CMS: select the element, click 'Get text from Categories' in the element settings panel, and choose your 'Description' field.
- Publish the site.
How to fix seo category description missing on PrestaShop
- In the PrestaShop back office, go to Catalog → Categories.
- Click Edit next to the category you want to update.
- Scroll to the 'Description' field — it has a built-in rich-text (TinyMCE) editor. Write or paste your 100–200 word description.
- Click Save.
- The description is displayed in your theme's category.tpl template file (themes/[your-theme]/templates/catalog/category.tpl). Most default themes (Classic, Hummingbird) display it above the product list automatically.
How to fix seo category description missing on OpenCart
- In the OpenCart admin, go to Catalog → Categories.
- Click Edit next to the category.
- In the 'Description' field on the General tab, use the rich-text editor to write your 100–200 word category description.
- Click Save.
- The description is rendered in your theme's category.twig (OpenCart 3+) or category.tpl (OpenCart 2) template. Most default themes display it at the top of the category page.
How to fix seo category description missing on Headless / Custom (I build in code)
- Add a 'description' field (rich text or markdown) to your category/collection schema in your data source — whether that's a headless CMS (Contentful, Sanity, etc.), a database, or a custom admin.
- Fill in unique 100–200 word descriptions for each category.
- In your category page template (React, Vue, Next.js, Nuxt, etc.), fetch the description field and render it as HTML above the product grid, e.g.: <div className='category-description' dangerouslySetInnerHTML={{ __html: category.description }} />
- Ensure the rendered HTML is present in the server-side rendered (SSR) or statically generated (SSG) HTML output — not loaded lazily after page paint — so Google can crawl it without executing JavaScript.
- Apply light styling (max-width, readable font size) so the description is visually prominent.
How to fix seo category description missing on Next.js (Headless)
- In your headless CMS or commerce API (e.g. Shopify, Contentful, BigCommerce), ensure every category/collection record has a `description` field of 100–200 words. Populate it for every category that is currently missing one.
- Open your category page route file — typically `app/[category]/page.tsx` (App Router) or `pages/category/[slug].tsx` (Pages Router) — and fetch the category description alongside the existing data in `generateStaticParams` / `getStaticProps`.
- For the App Router: export a `generateMetadata` function that maps the fetched description to `description` in the returned metadata object, so the `<meta name='description'>` tag is server-rendered for crawlers.
- Render the description text visibly on the page inside a semantic `<section>` or `<p>` element below the category heading and above the product grid. Visible body copy carries more ranking weight than meta tags alone.
- Add a `Category` JSON-LD block (using `@type: 'ItemList'` or `'CollectionPage'`) with a `description` property via a `<Script type='application/ld+json'>` component so the description is also machine-readable in structured data.
- Run `next build` and validate with Google's Rich Results Test and a `curl` of the rendered HTML to confirm the description appears in both the `<meta>` tag and the visible DOM before deploying.
How to fix seo category description missing on Elementor
- In your WordPress dashboard, go to Templates → Theme Builder. Locate (or create) the Archive template that controls your WooCommerce category pages — it is typically labeled 'Product Archive' or 'WooCommerce Archive'.
- Open the Archive template in the Elementor editor. Identify where the category header section sits (usually near the top, containing the category title). If no description widget exists yet, click the '+' icon to add a new widget in that section.
- Drag a 'Text Editor' widget (or an 'Archive Description' widget if your theme/Elementor Pro exposes it) into the category header section, placed directly below the category title widget.
- If using the 'Archive Description' widget, it will automatically pull the description you save in WooCommerce. If using a plain 'Text Editor' widget, switch to using the Archive Description widget instead so the text is dynamic and unique per category.
- Save the template, then go to WooCommerce → Products → Categories. Edit each category one by one, and in the 'Description' field write a 100–200 word paragraph explaining what products the category contains, the key use cases, and who they are for — incorporating the target category-level keyword naturally.
- Update each category and verify the description renders correctly on the live category page. Use a browser SEO tool (e.g., the 'SEO Meta in 1 Click' browser extension) to confirm the description text is present in the page's crawlable HTML and not hidden inside a collapsed/accordion element.
How to fix seo category description missing on Gatsby
- Open (or create) your category page template, typically located at src/templates/category.jsx (or src/pages/[category].jsx if using the File System Route API). This is where category data is fetched and rendered.
- In your GraphQL page query (or gatsby-node.js createPage context), ensure the category object includes a `description` field sourced from your CMS/commerce backend. If the field is empty, fall back to a programmatically generated string using the category name and product count.
- Render the description in the page body inside a clearly marked <section> or <div> element (e.g., below the hero/banner, above the product grid) so both users and Googlebot can read it as real, crawlable HTML — never hide it with CSS.
- Add the description to the page <head> as a meta description using Gatsby's Head API export (gatsby >= 4.19) or react-helmet. Keep the meta description to 155 characters (truncate if needed), while the visible body copy can be the full 100–200 words.
- Verify the output with `gatsby build && gatsby serve`, inspect the rendered HTML to confirm the description text appears in the DOM and in the <meta name='description'> tag, then run a Lighthouse/Google Rich Results check.
How to fix seo category description missing on Remix
- In your Remix project, locate the route file that renders category pages — typically something like `app/routes/categories.$handle.tsx` (or `.jsx`). This is where you'll add the description content.
- Fetch the category description from your data source (CMS, Shopify Storefront API, custom DB, etc.) inside the route's `loader` function. If no description field exists yet, add one to your data model first. Example: `const category = await getCategoryByHandle(params.handle); return json({ category });`
- In the route's page component, destructure the `category` from `useLoaderData()` and render the description in a visible `<p>` (or `<div>`) tag placed directly below the category heading — not hidden via CSS — so both users and Googlebot can read it. Example: `<p className="category-description">{category.description}</p>`
- Using Remix's `meta` export, also surface the description as the page's `<meta name="description">` tag so Google can use it in SERPs. Example: `export const meta = ({ data }) => [{ name: 'description', content: data.category.description }];`
- For every category that currently has no description, write a 100–200 word text in your CMS/data source explaining what products the category contains and who they are for, naturally incorporating the target category-level keyword (e.g. 'women's running shoes'). Save and redeploy if descriptions are hard-coded, or publish via the CMS if content is fetched at runtime.
- After deploying, use `curl -A Googlebot <your-category-URL>` or Google Search Console's URL Inspection tool to confirm the description text appears in the server-rendered HTML (Remix SSR/SSG ensures it is present before JS executes), then request re-indexing for each updated category URL.
Does your site have this issue?
Run a free SEOLZ scan to find seo category description missing — and every other issue — across your whole site in minutes.
Scan my site freeFrequently asked questions
What is Seo category description missing?
A category description is a short block of text — typically 100 to 200 words — placed on a collection, department, or category page that explains what products shoppers will find there and why those products are relevant to them. Think of it as an introduction to the aisle: "This is our range of waterproof hiking boots, designed for trail runners and weekend trekkers who need ankle support and grip in wet conditions." Without it, the page is essentially just a grid of product images with no written context for either visitors or search engines.
Why does seo category description missing matter?
Category pages are among the highest-value pages on any ecommerce store — they target broad, high-volume keywords like "women's running shoes" or "organic skincare" that drive enormous organic traffic. Google needs readable, unique text to understand what a page is about and to decide whether it should rank for those terms. A category page with zero descriptive text gives Google nothing to work with, so it will rank product pages or competitors' category pages instead, costing you significant organic traffic and revenue. A well-written description also improves click-through rates by giving Google material to generate a useful search snippet, and it builds shopper confidence by immediately confirming they've landed in the right place.
How do I fix seo category description missing?
Write a 100–200 word description for every category page explaining what products it contains and who they are for, so Google can rank it for category-level keywords.
Authoritative references
- Control your snippets & meta description — Google Search Central
- SEO Starter Guide — Google Search Central