How to add FAQPage schema that matches your visible content

AI Search Score checks for FAQPage schema when your page has a question-and-answer section. It’s one of the most quotable formats for AI engines — but the schema must reflect content people can actually see.

Why this matters

FAQ content is naturally structured as direct question→answer pairs, which is exactly what AI engines like to lift and cite. FAQPage schema makes those pairs machine-readable. The catch: the schema must match visible on-page FAQs. Hidden or schema-only FAQs violate Google’s guidelines and can get you ignored or penalised.

How to fix it

First, put a real FAQ section on the page (visible H2 + questions and answers). Then add matching FAQPage schema:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Your first question, worded as a visitor would ask it?",
      "acceptedAnswer": { "@type": "Answer", "text": "A clear, direct answer that matches what's shown on the page." }
    },
    {
      "@type": "Question",
      "name": "Your second question?",
      "acceptedAnswer": { "@type": "Answer", "text": "The visible answer." }
    }
  ]
}
</script>

The questions and answers in the schema should mirror what’s on the page, word for word in substance. Don’t add FAQ schema for content that isn’t visible.

How to check it worked

Re-scan. “FAQPage schema present” should turn green. Confirm the visible FAQ on the page matches the schema — substance should align.

Prefer this done for you? See our services.