How to fix missing schema faqpage on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. SSH into your server or use your deployment pipeline to access theme files.
2. Identify the relevant layout XML file for your page type (e.g. cms_page_view.xml for CMS pages, catalog_product_view.xml for product pages) inside app/design/frontend/<Vendor>/<theme>/Magento_Theme/layout/ (create the directory if needed).
3. Add a block of type Magento\Framework\View\Element\Template that points to a new .phtml template file you create (e.g. templates/schema/faqpage.phtml).
4. In that .phtml file, output your <script type='application/ld+json'> FAQPage JSON-LD. Use PHP variables from the block's data source (a custom block class or CMS field) to make question/answer content dynamic.
5. For BreadcrumbList: Magento already has breadcrumb block logic; install or configure a structured data extension such as 'MageWorx SEO Suite' or 'Amasty SEO Toolkit' to output BreadcrumbList JSON-LD automatically alongside FAQPage.
6. Run bin/magento cache:flush, then validate with Google's Rich Results Test.

{
  "@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.