Skip to main content

Learn · How-To

SEO Fundamentals Intermediate

How to Add FAQ Schema Markup to Your Website

FAQ schema markup — technically FAQPage structured data — tells search engines which text on your page is a question and which is its answer. Google stopped showing FAQ rich results in Search from 7 May 2026, and there is no demonstrated evidence that AI assistants read JSON-LD specifically, so treat this as housekeeping that helps search engines understand the page, not as a way to win an AI Overview or a chat citation. FAQPage remains a valid schema.org type, and existing markup can safely stay in place.

About 1 hour 7 steps Last updated:
  1. 1

    Identify your best FAQ candidates

    Look at the real questions customers ask in emails, calls, and reviews — not just keywords from a tool. The strongest FAQ schema candidates are specific, factual questions with a clear, self-contained answer of 40-100 words, written in plain language.

  2. 2

    Write self-contained question-and-answer pairs

    Each answer should make sense on its own, without needing the rest of the page for context. Avoid "see above" or "as mentioned earlier" — readers, and any tool that quotes the answer, may meet it as a standalone unit, so it needs to be complete by itself.

  3. 3

    Choose your implementation method

    If your site runs on WordPress, plugins like Yoast SEO or RankMath can generate FAQPage schema from a content block with little technical work. For custom-built sites, structured data is added directly as JSON-LD in the page's HTML.

  4. 4

    Build the FAQPage JSON-LD structure

    The schema needs an "@type": "FAQPage" object containing a "mainEntity" array, where each item is a "Question" with a "name" (the question text) and an "acceptedAnswer" of type "Answer" containing the "text" (the answer). Each pair should match the visible content on the page exactly.

  5. 5

    Add the schema to your page

    Insert the JSON-LD as a <script type="application/ld+json"> tag. On most platforms this can go in the page template or a dedicated SEO/structured-data field — it doesn't need to be visible to users, only present in the page's HTML source.

  6. 6

    Validate the markup

    Paste your live page URL into the Schema Markup Validator to confirm the FAQPage schema parses with no errors. Fix any warnings about missing required fields before publishing — invalid schema is often ignored entirely rather than partially used.

  7. 7

    Check Search Console and re-test your questions

    After Google has recrawled the page, check Search Console for any structured data issues reported against it. You can also periodically ask your target questions in ChatGPT, Perplexity and Google to see how they answer, but a change in those answers cannot be attributed to the markup.

Pro tips

  • Keep your visible FAQ content and your schema content identical — mismatches can be treated as a quality signal violation.
  • Don't mark up promotional content as FAQs; schema is meant for genuine, helpful questions and answers.
  • To use FAQPage alongside WebPage schema, either publish them as separate JSON-LD blocks or place both inside one @graph array: give the WebPage an @id and connect the FAQPage to it with isPartOf or mainEntityOfPage. The visible questions must still match the markup.
  • Google stopped showing FAQ rich results in Search from 7 May 2026, so treat FAQ markup as clarity for search engines rather than a route to a rich result.

Want help putting this into practice?

Take our 2-minute quiz to see where your business stands, or talk to a specialist about getting this done for you.

More how-to guides

Book a 15-Minute Strategy Call →