How to add FAQ schema on any website platform

Why this matters

An FAQ page is readable by a person but ambiguous to a machine — nothing in the HTML says which text is a question and which is its answer. FAQPage structured data removes the guesswork by labelling each pair explicitly. That matters more now than it did for rich results alone: answer engines lean heavily on structured data when deciding what a page actually asserts, and an unmarked FAQ is far easier to skip than a marked one.

What you paste

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How long does delivery take?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Orders placed before 2pm ship the same working day and arrive in 2-3 working days."
      }
    }
  ]
}
</script>

One Question object per question, each with exactly one acceptedAnswer. Replace the example with your own wording — the answer text must match what a visitor sees on the page.

Where it goes, by platform

The code is identical everywhere. The screen you paste it into is not, and neither is whether your plan allows it — 19 of 35 platforms require a paid plan for custom code.

How to check it worked

• Load the page and view source; the JSON-LD block should be present in the served HTML, not injected later by JavaScript.

• Run the URL through Google's Rich Results Test and confirm it detects FAQPage with the right number of questions.

• Check that every answer in the markup appears verbatim on the visible page — markup that does not match the page is a guidelines violation.

What goes wrong

• Marking up questions that are not visible on the page. The structured data has to describe what a visitor can actually read.

• Putting FAQPage on a page that is not an FAQ. Product pages with a couple of questions are better served by leaving it off.

• Escaping errors in the JSON. A single unescaped quote invalidates the whole block silently.

Questions

Will this get me rich results?

Possibly, but treat that as a bonus rather than the point. The reliable benefit is that machines can now tell exactly which text answers which question, which matters for AI answer engines regardless of how search results look this year.

How many questions should I mark up?

All the ones genuinely on the page. There is no threshold that unlocks anything — the markup should simply be a faithful description of the page.