Skip to content
Methodology

FAQPage schema

ia.faq-schema · 2.7

Read SHOULD Recommendation AR-READ-08

Why it matters

FAQPage schema exposes questions and answers as separate machine-readable pairs. An agent can then use a direct answer without parsing prose.

How to fix it

Add FAQPage JSON-LD for the questions and answers that are visible on the page.

  1. Find the questions and answers that are visible on the page.

  2. Add a FAQPage entity with one Question and acceptedAnswer per pair.

    {
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [{
        "@type": "Question",
        "name": "Is there a free plan?",
        "acceptedAnswer": {"@type": "Answer", "text": "Yes. The free plan has 100 calls per day."}
      }]
    }

Test it with the free tool

Verify

Run a new scan for this checkpoint:

isagentready results {domain} --checkpoint ia.faq-schema
Details Mapping, lifecycle and references
AR mapping
Full match
Score role
Core
Introduced
2026-08-24
Revised
2026-08-29
Methodology version
2026-10-22

Checkpoint data (JSON)