How to Add FAQ Schema
To add FAQ schema, place FAQPage JSON-LD in the page that lists question and answer pairs matching the visible content exactly, then validate it with Google's Rich Results Test.
Know what FAQ schema does and does not do
FAQPage structured data marks up a list of questions and their answers so search engines and AI systems can read them cleanly. It makes your Q&A content extractable, which helps with answer engines and can support rich presentation.
Be realistic about rich results: Google has limited the classic FAQ rich snippet to certain site types, so treat the visible rich result as a possible bonus rather than the goal. The durable benefit is clean, machine-readable Q&A that answer engines can quote.
Write the JSON-LD
Use JSON-LD in a script tag of type application/ld+json. Set the type to FAQPage, then add a mainEntity array where each item is a Question with a name (the question text) and an acceptedAnswer of type Answer with a text field holding the answer.
Keep the answer text as plain sentences; basic HTML is allowed in the answer text field but avoid injecting links or markup that does not appear on the page. Put one FAQPage block per page and include every visible FAQ you want represented.
Match the markup to what users see
The single most important rule is that the questions and answers in your schema must be present and visible on the page. Marking up content that a user cannot see, or that differs from the visible copy, violates the guidelines and can trigger manual action.
Do not use FAQ schema for content that is not genuinely a question and answer, and do not stuff it with promotional or keyword-loaded text. Keep it to real user questions with honest, useful answers.
Validate and monitor
Run the page through Google's Rich Results Test and the Schema Markup Validator to catch syntax errors and missing required fields before shipping. Fix any warnings about mismatched or empty fields.
After publishing, watch Search Console's enhancement and rich result reports for FAQ errors, and re-validate whenever you change the visible FAQ content so the markup never drifts out of sync with the page.
Frequently asked questions
Will FAQ schema guarantee a rich snippet?
No. Google decides whether to show rich results and has restricted FAQ snippets to certain site types. Valid schema makes your Q&A machine-readable, which still helps answer engines even without a visible snippet.
Can I mark up FAQs that are hidden behind an accordion?
Yes, as long as the content is present in the page's HTML and accessible to the user by interacting, not injected only for crawlers. It must match what users can actually read.
Keep reading
Want this machine pointed at your site?
This page is one of a swarm we generated for ourselves. We build the same for you.
Get Started - $10,000