How-To

How to add FAQPage schema to a page?

Answer

Add a JSON-LD script tag in the page head with @type FAQPage and a mainEntity array of Question entries. Each Question has 'name' (the question text) and 'acceptedAnswer.text' (the canonical answer). Validate with Google's Rich Results Test before deploying.

Minimum required fields

@context (https://schema.org), @type (FAQPage), mainEntity (array). Each mainEntity is @type Question with name, and acceptedAnswer of @type Answer with text. Three to twenty Q&A pairs is typical.

Implementation tips

Match Question.name exactly to the visible question on the page. Match acceptedAnswer.text to the visible answer. Inconsistency between schema and visible content is a Google policy violation.

How to validate

Paste the rendered page URL into Google's Rich Results Test. Confirm no errors. The AI Agent Readiness Check tests for FAQPage as one of the high-value schema types.

Want help shipping AEO into your site?

Run the free 50-signal AI Agent Readiness Check or book a free scoping call.

Score my site