How do I add FAQ schema to my website?
Short answer
FAQ schema is a block of structured code placed in the head of a webpage that tells search engines and AI tools which questions your page answers and what the answers say. Adding it involves writing your question-and-answer pairs in JSON-LD format, placing that code block in your page head, and testing the result in Google's Rich Results Test.
Updated August 3, 2026
FAQ schema is a piece of structured data that you add to a web page to tell search engines which questions the page answers and what those answers say. It uses a format called JSON-LD, which stands for JavaScript Object Notation for Linked Data. You place a block of code in the head section of your page, and search engines read it automatically.
The reason to add FAQ schema is that search engines and AI tools can use this structured version of your content more reliably than they can extract information from body text. A search engine reading plain text has to guess which parts are questions and which are answers. FAQ schema removes the guesswork by labeling them explicitly.
What FAQ schema looks like
The code is written in JSON-LD format. The outer wrapper sets the context and type: an object with a context pointing to schema.org and a type of FAQPage. Inside it, a mainEntity array holds each question. Each question has a type of Question, a name field with the question text, and an acceptedAnswer object that contains the answer text.
You add as many Question objects as you have visible questions on the page. Each question needs a name (the question text) and an acceptedAnswer with a text field (the answer text). The questions in the schema must match the questions visibly written on the page itself. If the schema says one thing and the page says another, the schema may be ignored.
Where to place the code on your page
The JSON-LD block goes in the head section of your HTML, inside a script tag with type set to application/ld+json. On most modern frameworks and CMS platforms, that means adding a single script element containing your schema object. Place that block in the head section of every page where you have visible FAQ content.
Adding schema in common platforms
How you add it depends on what your site is built on. Most major CMS platforms have a way to inject code into the head of specific pages.
- WordPress: use a plugin like Yoast SEO, Rank Math, or a code injection plugin to add the JSON-LD block to specific pages.
- Webflow: use the page settings panel to add custom code to the head section of individual pages.
- Squarespace: use the Advanced settings or a code block in a specific location on the page.
- Custom-built sites (Next.js, Astro, etc.): add the script tag directly in the page component head, or use a metadata utility to inject it.
- Shopify: use the theme code editor to add head code to product or collection pages.
Testing your schema
After adding the schema, test it using Google's Rich Results Test. Paste your page URL or the raw code into the tool and run the test. It will show you whether the schema is valid, flag any errors, and show a preview of how the structured data is interpreted. A passing test means the schema is correctly formatted and eligible for rich results.
Writing good FAQ content for schema
Schema amplifies your FAQ content; it does not improve it. If your FAQ answers are vague or unhelpful, making them structured data will not help them perform better. Write each answer as a complete, useful response to the question. Aim for two to five sentences that fully address what someone asking that question actually wants to know.
Use the same language your customers use when asking the question. If people search for how much does it cost and your FAQ says what is the investment, you are using different language from what they are looking for. Match the question phrasing to how the query is actually searched.
FAQ schema and AI search visibility
Search engines and AI tools use FAQ schema to identify citable content on your page. When an AI tool generates an answer to a query, it is more likely to pull from pages where the question-and-answer structure is clearly labeled. FAQ schema makes it easier for the tool to extract and use your answer correctly.
This is one of the core recommendations in answer engine optimization: structure your content so AI can extract and quote it cleanly. FAQ schema is the most direct way to do that for question-based content.
FAQ schema works alongside other structured data types. An AI-ready website typically includes Organization schema for your business identity, Article schema for blog and answer content, and FAQ schema on answer and service pages. Each type tells AI a different thing about your site.
How many FAQ questions to include
Include every question that you genuinely answer on the page. Between three and eight is a typical range. Do not add questions that are not visibly answered on the same page. Do not copy FAQ schema from other pages to speed up the process; each page's schema should reflect only the questions on that specific page.
For the full sequence of steps involved in making your site visible to AI tools, the GEO and AEO checklist covers structured data alongside content structure, page speed, and other factors in a practical order.
If you want help implementing structured data across your site as part of a broader AI visibility strategy, our answer engine optimization services include schema implementation alongside content structure and the other factors that help your content get cited.