Structured data
FAQ Schema and visible FAQ content: how to implement both correctly
A useful FAQ answers genuine customer questions in visible, accessible page content before it adds FAQPage schema. Mark up only the questions and complete answers a visitor can read on that URL, preserving their meaning and updating both representations together. Do not add hidden questions solely for machines. FAQ schema must match visible page facts and is not a guaranteed AI ranking factor, rich-result trigger or source of citations in an assistant.
Choose questions from customer evidence
Use support tickets, sales calls, on-site search, product research and policy confusion to identify recurring questions. Prioritize those that help a reader decide, act or avoid a costly misunderstanding. Write the question in the language customers use, then answer it directly in the first sentence. Follow with essential qualifications, a worked example or a link to the authoritative policy. Avoid interchangeable "What is your company?" filler and keyword variations whose answers repeat the main page without adding utility.
Make the visible FAQ the source of truth
- Render question and answer text in HTML that remains available without a special login or hover.
- Accessible accordions are acceptable when their controls, focus order and content work correctly.
- Keep answers specific to the page, product version, market and effective date where relevant.
- Link to canonical pricing, policy or documentation pages for details likely to change.
- Assign an owner and review date for operational, legal and safety-sensitive answers.
- Remove obsolete questions from the visible page and JSON-LD in the same deployment.
Draft a focused set with the FAQ generator, then use the schema validator to check the deployed FAQPage graph. Each mainEntity should be a Question whose acceptedAnswer contains the same substantive answer shown to users. Minor formatting differences are inevitable, but meaning, conditions and links must not conflict. Do not mark up user-generated discussion as accepted brand answers, and never use FAQPage to smuggle testimonials, repeated calls to action or claims that the page does not substantiate.
QA meaning as well as syntax
- Compare every structured question with a visible question on the canonical page.
- Normalize whitespace and markup, then review whether the complete answer meaning is preserved.
- Follow answer links and check that qualifiers, dates and policy destinations remain current.
- Test accordion interaction with keyboard, mobile and JavaScript-disabled experiences.
- Ask supported assistants the same questions and record answers, sources and omissions.
- Use support feedback to revise the visible answer before regenerating the structured data.
Run an AI visibility scan for the questions with the highest decision impact, then monitor them in ModelSaid across ChatGPT, Claude, Gemini and Perplexity. Tag incorrect answers by severity and by the likely authoritative page. A newly correct response does not prove FAQ schema caused the change, and a missing citation does not mean the FAQ is useless. Measure customer outcomes too: reduced repeated support contacts, successful task completion and fewer pricing or policy misunderstandings provide firmer evidence that the content itself works.
Design answers for reuse without making them vague. The opening sentence should stand on its own when quoted, while the following sentences preserve exceptions that prevent a wrong decision. Replace pronouns such as "it" with the product or policy name when context could be lost. Use concrete dates instead of "recently," and identify the market when terms differ by country. However, do not repeat the same boilerplate in every answer; link to a shared source for long legal or technical detail. This structure helps humans scan the page and reduces the chance that a short extracted passage reverses the intended meaning. Ask support and product owners to read each answer out of page context; if it becomes misleading when isolated, rewrite the lead sentence or bring the qualification forward.
Maintain FAQs as an editorial product
Review high-risk answers whenever pricing, terms, eligibility or product behavior changes. Track the question, canonical answer owner, last verification date and dependent pages in a simple register. Resist unlimited FAQ growth: when several answers become a full workflow, move them into dedicated documentation and keep a concise link. Search products can limit or change how they use FAQ markup at any time. The defensible implementation is therefore a genuinely helpful page with structured data as a faithful machine-readable copy, not an invisible optimization layer.
Is your business visible in AI search?
Run a free check and see what ChatGPT, Claude, Gemini and Perplexity actually say about you right now.
Check your business for free