How to fix seo category description missing on Gatsby

Steps for Gatsby

1. 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.
2. 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.
3. 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.
4. 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.
5. 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.

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.

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.

See the complete Seo category description missing guide for every platform and the full background.