ALTIOR
← AI Answers

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.

FAQ

Related questions

Does FAQ schema guarantee my page will appear in Google search features?

No. Valid FAQ schema makes your page eligible for rich results, but Google decides whether to display them based on content quality, relevance to the query, and other factors. Valid schema improves your eligibility; it does not guarantee the feature appears.

Can I add FAQ schema to every page on my site?

Only add FAQ schema to pages that have visible question-and-answer content. Google's guidelines say the schema should reflect what is visibly on the page. Adding it to pages without real FAQs is a violation of the guidelines and can result in the structured data being ignored or the site receiving a manual action.

Does FAQ schema help with AI tools like ChatGPT and Perplexity?

Yes, indirectly. Structured data helps AI tools identify and extract your content accurately. ChatGPT's training data includes pages that were well-structured at the time they were crawled. Perplexity and similar tools that search in real time can use schema to understand your page structure when generating answers.

What is the difference between FAQ schema and HowTo schema?

FAQ schema labels question-and-answer pairs on a page. HowTo schema labels the steps in a process. Use FAQ schema for pages that answer distinct questions. Use HowTo schema for pages that walk through a step-by-step process. They serve different content types and are not interchangeable.

How often should I update my FAQ schema?

Update it whenever the visible FAQ content on the page changes. If you add a new question, add it to the schema. If you change an answer, update the corresponding schema text to match. Keeping the schema in sync with the visible content is the most important maintenance task.

Can I have both FAQ schema and Article schema on the same page?

Yes. Multiple schema types can coexist on the same page. An answer page can carry Organization schema describing the business, Article schema describing the content piece, and FAQPage schema labeling the question-and-answer pairs. Each serves a distinct purpose and they do not conflict.

Ready when you are

Want this answered for your business?

Take the free AI check or book a call. We'll give you a straight read on where AI actually fits, no pressure.