How to add FAQ schema to a page

FAQ schema (FAQPage in schema.org) lets Google display question-and-answer pairs directly in search results as an expandable accordion. The visible-question area on the search result is significantly larger than a normal blue link, lifting click-through rate. This guide implements FAQ schema correctly.

1. 1

   Write at least 3 genuine Q&A pairs

   Google requires the questions and answers to actually appear on the page (not just in the structured data) and to be genuinely useful. Don't include marketing copy or rephrased product descriptions — write real customer questions.

2. 2

   Render the questions and answers visibly on the page

   Each question is a heading or accordion title; each answer is the body that follows. Visible rendering is mandatory — schema without matching visible content is a policy violation.

3. 3

   Generate the FAQPage JSON-LD

   Use the schema.org FAQPage type with @type: 'Question' for each pair, and @type: 'Answer' for the answer. The text in the schema must match the visible text on the page word-for-word.

4. 4

   Embed the JSON-LD in a script tag

   Place the generated JSON inside `<script type='application/ld+json'>` in the page's head or body. Most modern frameworks let you do this in the page template.

5. 5

   Validate in Google's Rich Results Test

   Open https://search.google.com/test/rich-results, paste your URL (or the rendered HTML), and confirm the FAQPage schema validates without warnings. Fix any errors before deploying.

6. 6

   Deploy and request indexing

   Deploy the change. In Google Search Console, request indexing for the URL. Rich results typically start appearing within 1-7 days.

7. 7

   Monitor for rich-result eligibility

   Check Search Console > Enhancements > FAQ regularly. Pages eligible for FAQ rich results appear here; warnings about errors or unmet requirements show what to fix.