SEOLZ

Missing schema faqpage

Moderate effort

Found on 34% of audited stores.

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

What it is

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.

Why it matters

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.

How to fix it

  1. Identify every page on your store that contains genuine FAQ-style question-and-answer content — product pages, shipping/returns pages, category pages, or a dedicated FAQ page.
  2. Write a JSON-LD script block that uses @type FAQPage. Each question becomes a Question object with a 'name' (the question text) and an 'acceptedAnswer' Answer object with a 'text' property (the answer text). Keep answers concise but complete — do not keyword-stuff them.
  3. If the page also displays a breadcrumb navigation trail, add a second JSON-LD block for BreadcrumbList, listing each crumb as a ListItem with its position, name, and URL.
  4. Paste both script blocks inside the <head> or at the end of the <body> of the relevant page(s). Each block is a separate <script type='application/ld+json'> tag.
  5. Validate your markup using Google's Rich Results Test (search 'Rich Results Test' in Google) by pasting the page URL or the raw code. Confirm zero errors for both FAQPage and BreadcrumbList.
  6. After publishing, submit the updated URL(s) in Google Search Console under URL Inspection › Request Indexing, then monitor the 'Enhancements' section for FAQ and Breadcrumb reports over the following weeks.
{
  "@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/"}
  ]
}

Fix it on your platform

Pick your platform for the exact steps.

How to fix missing schema faqpage on Shopify
  1. Go to Online Store › Themes › your active theme › Actions › Edit code.
  2. For FAQPage schema on a dedicated FAQ page: open Templates › page.faq.liquid (create it if it doesn't exist by duplicating page.liquid).
  3. Scroll to the bottom of that template file and paste your <script type='application/ld+json'> FAQPage block just before {% endblock %} or </div>.
  4. For BreadcrumbList on product/collection pages: open Snippets › and create a new snippet called 'schema-breadcrumb.liquid'. Paste your BreadcrumbList JSON-LD there, using Liquid variables like {{ product.title }}, {{ collection.title }}, {{ shop.url }} to make it dynamic. Then {% render 'schema-breadcrumb' %} from within product.liquid or collection.liquid.
  5. Alternatively, install a free app such as 'JSON-LD for SEO' or 'Schema Plus for SEO' from the Shopify App Store — these auto-generate both FAQPage and BreadcrumbList schema across relevant page types with no code editing required.
  6. Validate with Google's Rich Results Test after saving.
Full Shopify guide →Official Shopify docs ↗
How to fix missing schema faqpage on WooCommerce
  1. Install the free 'Rank Math SEO' or 'Yoast SEO' plugin (both have dedicated FAQ schema blocks).
  2. With Rank Math: edit any page/post in the block editor, open the Rank Math sidebar panel › Schema › Add New Schema › FAQ. Map each Q&A block automatically.
  3. With Yoast SEO Premium: use the FAQ block available in the Gutenberg block inserter ('Yoast FAQ block') — Yoast automatically wraps it in FAQPage JSON-LD.
  4. For BreadcrumbList: in Rank Math go to Rank Math › General Settings › Breadcrumbs and enable breadcrumbs; in Yoast go to SEO › Search Appearance › Breadcrumbs and enable them, then add <?php yoast_breadcrumb(); ?> to your theme template.
  5. For manual JSON-LD without a plugin: add the script block to your child theme's functions.php using wp_head action hook, or insert it via a plugin like 'Insert Headers and Footers'.
  6. Validate with Google's Rich Results Test.
Full WooCommerce guide →Official WooCommerce docs ↗
How to fix missing schema faqpage on BigCommerce
  1. Go to Storefront › Script Manager (requires store owner or approved app access).
  2. Click 'Create a Script'. Set Location to 'Footer', Pages to 'Specific Pages' (select your FAQ or product page), and paste your <script type='application/ld+json'> FAQPage block into the Script Content field.
  3. For BreadcrumbList: repeat the process with your BreadcrumbList JSON-LD block, targeting the same or relevant pages.
  4. Alternatively, open Storefront › Themes › Advanced › Edit Theme Files. Locate the relevant template (e.g. templates/pages/page.html for custom pages or templates/pages/product.html) and paste the JSON-LD block near the closing </body> tag.
  5. Use Stencil CLI for local development if you prefer editing theme files offline before pushing.
  6. Validate with Google's Rich Results Test.
Full BigCommerce guide →Official BigCommerce docs ↗
How to fix missing schema faqpage on Wix
  1. In the Wix Editor, open the page that contains your FAQ content.
  2. Click the page Settings gear icon (or go to Pages & Menu › right-click the page › Settings) and select 'SEO' tab.
  3. Scroll to 'Structured Data Markup' (also labelled 'JSON-LD') and paste your FAQPage JSON-LD block into the text area.
  4. Repeat for BreadcrumbList in the same field (Wix supports multiple JSON-LD blocks — separate them as distinct objects or use an array).
  5. Alternatively, use the Wix FAQ widget (Add Element › Interactive › FAQ) — Wix natively outputs FAQPage schema for pages built with this widget.
  6. Publish the site and validate with Google's Rich Results Test.
Full Wix guide →Official Wix docs ↗
How to fix missing schema faqpage on Squarespace
  1. In the Squarespace editor, go to Pages › select the FAQ page › Page Settings › Advanced tab.
  2. In the 'Page Header Code Injection' box, paste your <script type='application/ld+json'> FAQPage block.
  3. For BreadcrumbList: paste the BreadcrumbList JSON-LD block in the same 'Page Header Code Injection' area (or in Settings › Advanced › Code Injection › Header for site-wide injection).
  4. Note: Squarespace's built-in FAQ blocks do NOT automatically emit FAQPage schema — manual injection is required.
  5. If you are on a Squarespace Business plan or higher, the Code Injection feature is available; Personal plan users must upgrade.
  6. Publish and validate with Google's Rich Results Test.
Full Squarespace guide →Official Squarespace docs ↗
How to fix missing schema faqpage on Webflow
  1. Open the Webflow Designer and navigate to the page with FAQ content.
  2. Click the page Settings icon (wrench icon at top of the Pages panel) › Custom Code tab.
  3. In the 'Before </body> tag' section, paste your <script type='application/ld+json'> FAQPage block.
  4. Add your BreadcrumbList JSON-LD block in the same field (use separate <script> tags for each schema type).
  5. For CMS-driven FAQ pages: use Webflow CMS collections for Q&A content, then use an Embed element inside the CMS Collection template with Webflow's dynamic binding to pull question/answer fields into the JSON-LD — this keeps schema in sync with your content automatically.
  6. Publish the site and validate with Google's Rich Results Test.
Full Webflow guide →Official Webflow docs ↗
How to fix missing schema faqpage on 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.
Full Adobe Commerce (Magento) guide →Official Adobe Commerce (Magento) docs ↗
How to fix missing schema faqpage on 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.
Full WordPress.org guide →Official WordPress.org docs ↗
How to fix missing schema faqpage on PrestaShop
  1. Access your back office and go to Modules › Module Manager.
  2. Search for and install an SEO module such as 'SEO Expert' or 'Structured Data' by PrestaHero/others from the Addons Marketplace — most include FAQPage and BreadcrumbList schema generators.
  3. Alternatively, edit your theme's CMS page template directly: open themes/<your-theme>/templates/cms/page.tpl and paste your <script type='application/ld+json'> FAQPage block near the closing </body>.
  4. For BreadcrumbList: most PrestaShop themes include a breadcrumb snippet — find templates/layouts/layout-full-width.tpl and add the BreadcrumbList JSON-LD block, substituting Smarty variables like {$breadcrumb.links} for dynamic data.
  5. Clear the cache under Advanced Parameters › Performance › Clear Cache after making changes.
  6. Validate with Google's Rich Results Test.
Full PrestaShop guide →Official PrestaShop docs ↗

Does your site have this issue?

Run a free SEOLZ audit to find missing schema faqpage — and every other issue — across your whole site in minutes.

Scan my site free

Frequently asked questions

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.

Why does missing schema faqpage matter?

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.

How do I fix missing schema faqpage?

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

Authoritative references

Related Answer Engine Optimization issues