FAQ markup generator
Write the FAQ text and its FAQPage markup together, so they say the same.
- Generator
- 1 rule
- Last updated
What it checks
- Each question with its answer, from blocks separated by an empty line; “Q:” and “A:”, or «س:» and «ج:», at the start of a line are taken off.
- The page text and the markup are written from one list, so they match word for word, which the
faq-schema-mismatchcheck asks. <,&and quotes are escaped in the page, and a</script>in a question cannot end the markup block.- A block of one line (a question with no answer) is left out.
Example
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "كم يستغرق الشحن؟", "acceptedAnswer": { "@type": "Answer", "text": "يصل الطلب خلال يومين." } } ] } </script> <details> <summary>كم يستغرق الشحن؟</summary> <p>نشحن في أقرب وقت ممكن.</p> </details>
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "كم يستغرق الشحن؟", "acceptedAnswer": { "@type": "Answer", "text": "يصل الطلب خلال يومين." } } ] } </script> <details> <summary>كم يستغرق الشحن؟</summary> <p>يصل الطلب خلال يومين.</p> </details>
How to fix
Put the text where the FAQ should appear and the markup beside it, and generate both again whenever a question changes:
- Write real questions your customers ask, with answers that tell them something; not questions made for keywords.
- Keep the text visible: a closed
<details>is fine, text drawn by a script is not in the HTML a crawler reads. - Remove from the markup a question you remove from the page.
- On a platform, check whether an app already writes FAQ markup before adding more.
<details>
<summary>كم يستغرق الشحن؟</summary>
<p>يصل الطلب خلال يومين.</p>
</details>FAQ
No, not in Google Search. Google's Search Central updates log says FAQ rich results no longer appear in Google Search from 7 May 2026, and Google removed their documentation on 15 June 2026 (read on 12 November 2026). The markup still states the questions and answers plainly for software that reads it, but no Google rich result comes of it.
Google asks that structured data describe what the visitor can see. Markup for hidden or missing content is against its policies.
No. The generator runs in your browser, and nothing you type leaves it.
What this tool runs
- FAQ markup says what the page does notmoderate
faq-schema-mismatch
How we measure
The generator runs in your browser. The page text and the FAQPage block are written from one list of questions, and a test runs the faq-schema-mismatch check over what it writes: it finds nothing. A < in the JSON is written as an escape.