How to add FAQ sections with FAQPage structured data
A FAQ section marked up with FAQPage structured data gives assistants ready-made question and answer pairs to cite. Add 3 to 6 real questions people ask, keep each answer under 100 words, and mirror the visible text exactly in the JSON-LD.
By ratemysite.ai editorial team. Updated .
How do you fix it?
- Collect 3 to 6 real questions from support emails, search suggestions and sales calls.
- Write each answer in plain text, under 100 words, and show the questions and answers visibly on the page.
- Add a JSON-LD script with @type FAQPage and one Question with an acceptedAnswer for each pair.
- Make sure the JSON-LD text matches the visible text, then test it with the Rich Results Test.
- Re-run the audit and confirm the FAQ schema check passes.
What is FAQPage structured data?
FAQPage is a Schema.org type that describes a page made of questions and their answers, written as JSON-LD code in the page. It turns a plain list of questions into data that a program can read without guessing where each answer ends. Assistants and search engines use that data to build short answers and to attribute them to you. A page with a clear FAQ section also gives visitors the follow-up answers they need.
How do I choose good questions?
Use the exact words people type or say: start with a question word, keep it specific and cover one idea. Avoid questions that only promote you, like "Why are we the best?". Aim for 3 to 6 questions per page, since more rarely helps. Write the answer to be understood alone, in one to three sentences, and put the most important fact first. Update the answers whenever the product or policy changes so the markup never goes stale.
How much does this check matter?
- This check is worth about 3.1% of the overall score.
- A finished report is reused for 24 hours before you can re-analyze it.
- Each page is fetched with a timeout of 10 seconds, and HTML larger than 2 MB is not audited.
What else do people ask?
- Does Google still show FAQ rich results?
- Google limited FAQ rich results to a few authoritative sites in 2023, but the markup is still valid and other engines and assistants can read it.
- Can I mark up questions that are not on the page?
- No. Markup must describe content visitors can see. Hidden or mismatched FAQs can be ignored or flagged as spam.