Missing schema faqpage

Quick win

Found on 73% of audited stores.

Add FAQPage schema markup to any page that contains a Frequently Asked Questions section so Google can display your answers as rich results directly in search.

What it is

FAQPage schema is a small block of structured data (hidden code) you add to a webpage that tells Google "this page contains questions and answers." It uses a standardized vocabulary (Schema.org) so search engines can reliably read and understand your FAQ content — even if it looks different from other sites. The markup lives in a `<script>` tag in the page's HTML and is invisible to shoppers but fully readable by search crawlers.

Why it matters

When Google recognizes valid FAQPage markup, it can expand your search listing to show individual questions and answers directly below your blue link — sometimes doubling or tripling the vertical space your result occupies on the results page. This "rich result" appearance dramatically increases click-through rates because shoppers see your answers before they even visit your site, building trust instantly. For ecommerce stores, FAQ sections on product, shipping, or returns pages are prime candidates: a richer listing means more qualified clicks, lower bounce rates, and more conversions. Without the markup, Google may never discover your FAQ content exists, and a competitor who has the markup can capture that expanded real estate instead of you.

How to fix it

  1. Identify every page on your store that already has a FAQ section — common candidates include product pages, shipping/returns policy pages, a dedicated FAQ page, and checkout help pages.
  2. For each FAQ page, compile the exact question text and its corresponding answer text; answers must match what is visibly shown on the page (do not add hidden Q&A that shoppers cannot see).
  3. Build a JSON-LD script block using the FAQPage schema: set @type to FAQPage and list each Q&A pair inside mainEntity as a Question object with an acceptedAnswer Answer object.
  4. Paste the completed <script type='application/ld+json'> block into the <head> or at the end of the <body> of the relevant page(s) — do NOT place it in a location that is hidden from users.
  5. Validate your markup using Google's Rich Results Test (search 'Rich Results Test') to confirm there are no errors or warnings before publishing.
  6. After publishing, monitor Google Search Console under Enhancements → FAQ to track impressions, clicks, and any manual action notices related to the markup.

Fix it on your platform

Pick your platform for the exact steps.

How to fix missing schema faqpage on Shopify
  1. In your Shopify Admin, go to Online Store → Themes → click 'Customize' on your active theme.
  2. For a standalone FAQ page: go to Online Store → Pages, open the FAQ page, switch the content editor to HTML view, and paste the JSON-LD <script> block at the very top or bottom of the page HTML field.
  3. For product pages: go to Online Store → Themes → Edit Code → open 'templates/product.liquid' (or 'sections/product-template.liquid' / 'sections/main-product.liquid' depending on your theme) and paste the JSON-LD block inside the file, just before the closing </section> or at the top of the template.
  4. Alternatively, install a free app such as 'Schema Plus for SEO' or 'SEO King' from the Shopify App Store — these apps auto-generate FAQPage schema from your page content with no code edits.
  5. Verify by visiting your live page URL in Google's Rich Results Test.
Full Shopify guide →Official Shopify docs ↗
How to fix missing schema faqpage on WooCommerce
  1. Install and activate the free 'Rank Math SEO' or 'Yoast SEO' plugin from the WordPress Plugin Directory — both include built-in FAQ schema blocks.
  2. For Rank Math: open any page in the WordPress block editor (Gutenberg), add a 'Rank Math FAQ Block' from the block inserter, type your questions and answers directly into the block — Rank Math outputs the FAQPage JSON-LD automatically.
  3. For Yoast SEO: open the page, add a 'Yoast FAQ' block via the block editor, fill in Q&A pairs — Yoast injects the schema on save.
  4. If you prefer manual JSON-LD: install 'Insert Headers and Footers' plugin, go to Settings → Insert Headers and Footers, and paste your <script> block in the footer section (or use a per-page plugin like 'WP Custom Code Shortcode').
  5. Check output with Google's Rich Results Test.
Full WooCommerce guide →Official WooCommerce docs ↗
How to fix missing schema faqpage on BigCommerce
  1. In your BigCommerce Admin, go to Storefront → Script Manager → click 'Create a Script'.
  2. Set 'Location on page' to Footer, 'Select pages where script will be added' to 'Specific pages', and choose the page containing your FAQ.
  3. Paste your complete JSON-LD <script type='application/ld+json'> block into the Script Content field and save.
  4. For theme-level edits: go to Storefront → Themes → click 'Advanced' → Edit Theme Files, open 'templates/pages/custom/page.html' (or the relevant page template), and insert the script block.
  5. Validate with Google's Rich Results Test using the live page URL.
Full BigCommerce guide →Official BigCommerce docs ↗
How to fix missing schema faqpage on Wix
  1. In your Wix dashboard, go to Settings → Custom Code (under the Advanced section).
  2. Click '+ Add Custom Code', paste your JSON-LD <script> block, name it 'FAQPage Schema', set 'Add Code to Pages' to the specific FAQ page (or all pages if FAQ appears site-wide), and set 'Place Code in' to 'Head'.
  3. Click Apply and publish your site.
  4. Alternatively, use the Wix SEO Wiz or install a third-party SEO app from the Wix App Market (e.g., 'SEOmatic') that supports custom schema injection per page.
  5. Verify the live page in Google's Rich Results Test.
Full Wix guide →Official Wix docs ↗
How to fix missing schema faqpage on Squarespace
  1. In your Squarespace dashboard, go to Settings → Advanced → Code Injection.
  2. Paste your JSON-LD <script> block into the 'Header' field for site-wide injection — OR, for a single page, open the page editor, click the gear icon (Page Settings) → Advanced tab → paste the script into the 'Page Header Code Injection' field (available on Business plan and above).
  3. Click Save and publish.
  4. Note: Per-page code injection requires a Business or Commerce plan; if on Personal plan, the site-wide Header injection is the only option.
  5. Validate with Google's Rich Results Test.
Full Squarespace guide →Official Squarespace docs ↗
How to fix missing schema faqpage on Webflow
  1. In the Webflow Designer, open the Page Settings for your FAQ page by clicking the Pages panel → hover over the page → click the gear icon.
  2. Scroll to the 'Custom Code' section at the bottom of Page Settings.
  3. Paste your JSON-LD <script> block into the 'Inside <head> tag' field and click Save.
  4. Publish your site for the changes to go live.
  5. Validate with Google's Rich Results Test using the published URL.
Full Webflow guide →Official Webflow docs ↗
How to fix missing schema faqpage on Adobe Commerce (Magento)
  1. In your Admin Panel, go to Content → Pages (or the relevant CMS page containing your FAQ).
  2. Open the page, switch the content editor to HTML mode, and paste the JSON-LD <script> block at the top of the HTML content — OR create a new Static Block (Content → Blocks) containing just the script and reference it in the page layout.
  3. For theme-level integration: add the script to the relevant .phtml template file under app/design/frontend/[Vendor]/[theme]/Magento_Cms/templates/ or the specific product/category template.
  4. Alternatively, install a schema markup extension from the Adobe Commerce Marketplace (search 'FAQ schema' or 'structured data') for a no-code approach.
  5. Flush the cache (System → Cache Management → Flush Magento Cache) after saving, 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 the WordPress Plugin Directory — it adds a dedicated FAQ block to the Gutenberg editor.
  2. Open any page with a FAQ section in the block editor, click the '+' to add a block, search for 'Rank Math FAQ', and enter your Q&A pairs — schema is generated automatically.
  3. If using a classic/page-builder theme (Elementor, Divi), use the plugin 'Schema & Structured Data for WP & AMP' which adds a metabox to every page where you can select FAQPage type and input Q&A pairs.
  4. For manual injection without a plugin: go to Appearance → Theme File Editor → open 'header.php' and paste the script just before </head> (wrapping it in a conditional to target only FAQ pages using is_page()).
  5. Validate with Google's Rich Results Test.
Full WordPress.org guide →Official WordPress.org docs ↗
How to fix missing schema faqpage on Wix Studio
  1. In Wix Studio, open your site's dashboard and navigate to Settings → Custom Code.
  2. Click '+ Add Custom Code', paste your JSON-LD <script> block, name it 'FAQPage Schema', select the specific page(s) it applies to, set placement to 'Head', and click Apply.
  3. Publish the site and validate the live URL in Google's Rich Results Test.
Full Wix Studio guide →Official Wix Studio docs ↗
How to fix missing schema faqpage on BigCommerce for WP
  1. Use the WordPress block editor to open the page containing your FAQ content.
  2. Install 'Rank Math SEO' and add a Rank Math FAQ Block, or manually add an HTML block and paste the <script type='application/ld+json'> code directly.
  3. Save and publish the page, then validate with Google's Rich Results Test.
Full BigCommerce for WP guide →Official BigCommerce for WP 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 ↗
How to fix missing schema faqpage on Elementor
  1. In your WordPress dashboard, go to Pages (or Posts) and open the page built with Elementor that contains your FAQ section. Click 'Edit with Elementor' to launch the Elementor editor.
  2. In the Elementor left panel, click the hamburger menu (☰) in the top-left corner, then go to Site Settings → Custom Code (Elementor Pro required). Alternatively, if you do not have Elementor Pro, install a lightweight plugin such as 'Insert Headers and Footers' to inject the schema — then skip to step 4.
  3. In Custom Code, click '+ Add New' and give the snippet a descriptive name such as 'FAQPage Schema – [Page Name]'. Set the 'Location' to 'In Page Head' and the 'Priority' to 10. Scope it to the specific page using the 'Include On' condition (e.g., 'Page → [Your FAQ Page]').
  4. Paste the following JSON-LD block into the code editor, replacing each Question/Answer pair with your actual FAQ content: <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Your first question here?", "acceptedAnswer": { "@type": "Answer", "text": "Your first answer here." } }, { "@type": "Question", "name": "Your second question here?", "acceptedAnswer": { "@type": "Answer", "text": "Your second answer here." } } ] } </script> Add or remove Question/Answer objects to match every FAQ item visible on the page.
  5. Click 'Apply' to save the Custom Code snippet, then click 'Publish' (or 'Update') in the Elementor editor to push the change live.
  6. Validate the output by copying the page URL and pasting it into Google's Rich Results Test (https://search.google.com/test/rich-results). Confirm it detects a valid 'FAQ' rich result with no errors before requesting indexing in Google Search Console.
Full Elementor guide →Official Elementor docs ↗
How to fix missing schema faqpage on Next.js (Headless)
  1. Identify every page that renders an FAQ section (e.g. app/faq/page.tsx, app/product/[slug]/page.tsx). The JSON-LD block must live on the same page as the visible Q&A content.
  2. Create a reusable FaqJsonLd component at components/seo/FaqJsonLd.tsx that accepts a typed array of { question, answer } pairs and renders a <script type='application/ld+json'> tag via Next.js's built-in <Script> or a plain <script> inside the JSX (see snippet).
  3. In each page file that uses the App Router, import FaqJsonLd and drop it anywhere inside the returned JSX — it renders no visible UI, only the <script> tag that Google crawls.
  4. If you use the Pages Router instead, import FaqJsonLd the same way; Next.js will hoist the <script> tag correctly because it contains no document.write calls.
  5. Ensure every question and answer string matches the visible text on the page exactly — Google cross-validates the schema against the rendered DOM.
  6. Deploy and validate with the Google Rich Results Test (https://search.google.com/test/rich-results) and Schema Markup Validator (https://validator.schema.org/) to confirm FAQPage rich results are eligible.
Full Next.js (Headless) guide →Official Next.js (Headless) docs ↗

Does your site have this issue?

Run a free SEOLZ scan 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?

FAQPage schema is a small block of structured data (hidden code) you add to a webpage that tells Google "this page contains questions and answers." It uses a standardized vocabulary (Schema.org) so search engines can reliably read and understand your FAQ content — even if it looks different from other sites. The markup lives in a `<script>` tag in the page's HTML and is invisible to shoppers but fully readable by search crawlers.

Why does missing schema faqpage matter?

When Google recognizes valid FAQPage markup, it can expand your search listing to show individual questions and answers directly below your blue link — sometimes doubling or tripling the vertical space your result occupies on the results page. This "rich result" appearance dramatically increases click-through rates because shoppers see your answers before they even visit your site, building trust instantly. For ecommerce stores, FAQ sections on product, shipping, or returns pages are prime candidates: a richer listing means more qualified clicks, lower bounce rates, and more conversions. Without the markup, Google may never discover your FAQ content exists, and a competitor who has the markup can capture that expanded real estate instead of you.

How do I fix missing schema faqpage?

Add FAQPage schema markup to any page that contains a Frequently Asked Questions section so Google can display your answers as rich results directly in search.

Authoritative references

Related Answer Engine Optimization issues