Free audit
SEO Intel AI Visibility Playbooks · Signal 2 of 9

FAQPage Structured Data: schema for AI engines

AI search engines extract Q&A content more reliably from pages with FAQPage JSON-LD schema. At 15 points and fixable in under an hour, this is the highest single-fix ROI in the AI Readiness Score.

Run your free AI Visibility audit All 9 signals
15 pointsHighest single-fix ROI30-60 minute fix
15 points available
Highest single-fix ROI

What this signal measures

AI search engines extract Q&A content more reliably when it is marked up with FAQPage JSON-LD structured data. The FAQPage schema type, defined in the Schema.org specification, tells crawlers that a page contains a list of questions with definitive answers. Without this schema, AI engines must parse your FAQ content as unstructured prose and may misattribute or skip questions entirely.

At 15 points, FAQPage schema has the highest single-fix return on investment of any AI Visibility signal. Most stores either have no FAQ page at all, or have a FAQ page with no schema. Both are fixable in under an hour.

How the score is calculated

SEO Intel checks for FAQPage JSON-LD in two places: the homepage (some themes embed FAQ schema directly in the homepage) and the page at /pages/faqs, which is the standard Shopify FAQ page handle.

Common failure modes

Issue 1: Most common

FAQ page exists but has no JSON-LD schema

The merchant has a /pages/faqs page written in plain HTML or Shopify rich text, but no <script type="application/ld+json"> block with "@type": "FAQPage". This is the partial-credit scenario: the questions are there, but the structured signal is absent.

Issue 2

No FAQ page exists at all

The store has no dedicated FAQ page. This is common in stores built from minimal themes or launched quickly. AI engines have no Q&A surface to extract from, reducing the likelihood of appearing in question-based queries.

Issue 3

FAQ schema exists but questions are vague or very short

Some store owners add FAQPage schema with questions that are too short to be useful to AI engines (e.g., "What is your returns policy?" answered with "See our policy page."). AI engines prefer answers that are self-contained and factual, not redirects to other pages.

How to fix it

Step 1. Create a FAQ page. In Shopify Admin, go to Online Store → Pages → Add page. Set the page title to "Frequently Asked Questions" and the page handle (URL slug) to faqs. Write 10 to 20 real questions your customers ask, each with a complete, self-contained answer of at least 2 sentences.

Step 2. Add FAQPage JSON-LD schema. Go to Online Store → Themes → Edit code. Open sections/main-page.liquid. Find or add a conditional block for the faqs page handle, then paste the following inside it (replace the example questions with your real ones):

{% if page.handle == 'faqs' %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is your returns policy?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "We accept returns within 30 days of delivery. Items must be unused and in original packaging. Contact us at support@yourstore.com to start a return."
      }
    }
  ]
}
</script>
{% endif %}

Step 3. Validate the schema. After saving, visit Google's Rich Results Test and enter your /pages/faqs URL. Confirm that FAQPage is detected with your questions listed. Then run the SEO Intel AI Visibility audit again to confirm the signal passes.

Not sure if your FAQ schema is correct? The free AI Visibility audit checks for FAQPage JSON-LD automatically and shows you the exact status. For a complete structured data walkthrough, also see the AI Visibility Playbooks hub.

Sources and references

Previous: AI Crawler AccessRead nextOrganization sameAs Completeness10 points

Frequently asked questions

What is FAQPage JSON-LD schema?
FAQPage JSON-LD is a block of structured data added to an HTML page that tells crawlers and search engines the page contains a list of questions and definitive answers. It uses the Schema.org FAQPage type and is embedded as a script tag with type='application/ld+json'. AI search engines use this structured data to extract Q&A pairs for use in conversational answers.
Does FAQPage schema help with Google search as well as AI search?
Yes. FAQPage schema can trigger Google Rich Results (expandable FAQ blocks in search results), which improves click-through rates in traditional Google search. It also improves AI search visibility because AI engines preferentially extract content that is already structured as Q&A. The same schema serves both purposes.
How many questions should my FAQPage schema include?
Aim for 10 to 20 questions. Each answer should be self-contained: someone reading only the answer should understand it without needing to click anywhere else. Answers of 2 to 4 sentences work well. Avoid single-sentence answers that redirect to other pages, as AI engines treat those as low-quality and may skip them.