How to fix missing schema faqpage on WordPress.org

Add FAQPage (and BreadcrumbList) JSON-LD structured data to pages that contain FAQ content so Google can display rich results directly in search.

Steps for WordPress.org

  1. Install 'Rank Math SEO' (free) from Plugins › Add New.
  2. Edit the page with FAQ content using the block editor. In the block inserter, search for 'Rank Math FAQ' and add the FAQ block — fill in your questions and answers. Rank Math automatically wraps this in valid FAQPage JSON-LD.
  3. For BreadcrumbList: in Rank Math › General Settings › Breadcrumbs, enable breadcrumbs and configure the separator/home label. Add <?php rank_math_the_breadcrumbs(); ?> to your theme template where you want the trail displayed — the JSON-LD is emitted automatically.
  4. If you prefer Yoast SEO: use the Yoast FAQ Gutenberg block (Yoast SEO Premium) for FAQPage schema, and enable breadcrumbs under SEO › Search Appearance › Breadcrumbs.
  5. For manual insertion without a plugin: add the JSON-LD via a Code Snippets plugin (search 'Code Snippets' in Add New Plugins) using a PHP snippet with wp_head hook.
  6. Validate with Google's Rich Results Test.
Official WordPress.org documentation ↗
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is your return policy?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "We accept returns within 30 days of purchase. Items must be unused and in original packaging. Contact support@example.com to start a return."
      }
    },
    {
      "@type": "Question",
      "name": "How long does shipping take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Standard shipping takes 3–5 business days. Express shipping (1–2 business days) is available at checkout."
      }
    }
  ]
}

<!-- BreadcrumbList (separate script block) -->
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/"},
    {"@type": "ListItem", "position": 2, "name": "Products", "item": "https://www.example.com/products/"},
    {"@type": "ListItem", "position": 3, "name": "Widget", "item": "https://www.example.com/products/widget/"}
  ]
}

What is missing schema faqpage?

Structured data is a standardised block of code — written in a format called JSON-LD — that you embed in a page to tell search engines exactly what the content means, not just what it says. FAQPage schema specifically labels your questions and answers so Google can understand them as a FAQ. BreadcrumbList schema labels your site's navigation path (e.g. Home › Products › Widget). Neither is visible to shoppers; they live in the page's source code and act as a direct signal to search-engine crawlers.

Pages with valid FAQPage schema are eligible for FAQ rich results — the expandable Q&A dropdowns that appear directly beneath your listing in Google Search. These rich results make your listing significantly taller and more eye-catching, often doubling the click-through rate compared to a plain blue link. For an ecommerce store, FAQ content on product, category, or support pages that answers "will this fit my X?" or "what is the return policy?" can capture high-intent shoppers before they ever visit a competitor. Missing this schema means you are handing those prominent placements to rivals who have implemented it. Additionally, as AI-powered answer engines (SGE, Bing Copilot) increasingly pull structured Q&A content to generate direct answers, having FAQPage markup improves your chances of being cited as the source.

See the complete Missing schema faqpage guide for every platform and the full background.

Not sure if your WordPress.org store has this?

Run a free SEOLZ audit — we’ll find missing schema faqpage and every other issue across your whole site.

Scan my site free

Fix missing schema faqpage on another platform