Seoxpert.io
Get started
mediumTechnical SEO

FAQPage Schema Without Matching Question Headings

FAQPage schema is present but lacks matching question-phrased H2/H3 headings on 15 pages.

By Seoxpert Editorial · Published

Why it matters

Google requires that FAQPage structured data accurately represents visible content. If FAQ schema questions do not match visible, question-phrased headings and answers, your FAQ rich results may not appear in search. This reduces your chances of enhanced visibility and click-through rates.

Impact

FAQ rich results will likely be suppressed or ignored by Google if schema questions are not matched by visible content.

How it's detected

An automated crawler compares FAQPage schema questions to visible H2/H3 headings, flagging mismatches or missing question-phrased headings.

Common causes

  • •FAQ schema added without updating page content.
  • •FAQ questions not phrased as questions in headings.
  • •FAQ answers missing or not visible on the page.
  • •Use of generic or unrelated headings for FAQ sections.

How to fix it

Update your page to ensure each FAQ schema question has a corresponding visible H2 or H3 heading phrased as a question, with a clear answer below. Use semantic HTML for headings and answers. Align the schema content with what users see to meet Google's requirements.

Code examples

Incorrect Example: FAQ schema without matching headings

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "How do I reset my password?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Click on 'Forgot Password' and follow the instructions."
    }
  }]
}
</script>

<!-- No matching H2/H3 heading on the page -->

Correct Example: FAQ schema with matching question heading

<h2>How do I reset my password?</h2>
<p>Click on 'Forgot Password' and follow the instructions.</p>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "How do I reset my password?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Click on 'Forgot Password' and follow the instructions."
    }
  }]
}
</script>

FAQ

Does every FAQ schema question need a visible heading?

Yes, each question in your FAQ schema should have a corresponding visible H2 or H3 heading phrased as a question.

Can I use H4 or lower headings for FAQ questions?

Google recommends using H2 or H3 headings for main questions to ensure clarity and semantic structure.

Will Google show FAQ rich results if headings and schema don't match?

No, Google may ignore or suppress FAQ rich results if the schema is not supported by visible, matching content.

Do the answers also need to be visible on the page?

Yes, each FAQ schema answer should have a corresponding visible answer below the question heading.

Found this issue on your site?

Run a scan to see if FAQPage Schema Without Matching Question Headings affects your pages.

Scan my website →