How to Add FAQ Schema Markup to Your Website (2026)
TL;DR
FAQ schema markup tells Google which parts of your page are questions and answers, so they can appear as expandable dropdowns directly in search results. This guide covers what FAQ schema is, how to write it in JSON-LD, and how to test it.
How to Add FAQ Schema Markup to Your Website (2026)
You've written a solid FAQ section on your page. Good questions, clear answers. But Google doesn't know it's an FAQ. Without the right markup, your frequently asked questions look like any other block of text to search engines.
FAQ schema markup fixes that. It tells Google which parts of your page are questions and answers, so they can appear as expandable dropdowns directly in search results. Those FAQ rich results can significantly increase your click-through rate.
This guide covers what FAQ schema is, how to write it in JSON-LD, how to add it to your site, and how to test it. If you'd rather skip the manual work, you can generate FAQ schema automatically in seconds.
What Is FAQ Schema Markup?
FAQ schema markup is a type of structured data you add to your HTML. It follows a vocabulary defined by Schema.org, which is the standard that Google, Bing, and other search engines use to understand page content.
When you mark up your FAQ section with this structured data, you're giving search engines a machine-readable version of your questions and answers.
The technical name is FAQPage schema. It's for pages where content is organized as a list of questions with answers. Product pages, help center articles, service pages, blog posts with a Q&A format, they all qualify.
Try Schema Markup Generator Free
Generate FAQ, HowTo, and other schema markup for rich results.
Open ToolNo signup required. Runs in your browser.
How FAQ Rich Results Look in Google
When Google picks up your FAQ structured data, your search listing gets expandable question-and-answer dropdowns right below your meta description. Each question appears as a clickable accordion.
This has two effects. Your listing takes up more real estate on the results page, pushing competitors further down. And users who click through are already engaged, they've read a question and want more.
FAQ rich results appear on both mobile and desktop. On mobile, they can dominate the screen.
The JSON-LD Format Explained
Google recommends JSON-LD (JavaScript Object Notation for Linked Data) as the preferred format for structured data. It's a script block you drop into your HTML. It doesn't affect how your page looks to visitors.
Here's the basic structure of FAQ schema in JSON-LD:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is FAQ schema markup?",
"acceptedAnswer": {
"@type": "Answer",
"text": "FAQ schema markup is structured data you add to your website's HTML to help search engines understand your FAQ content. It can make your questions and answers appear as rich results in Google."
}
},
{
"@type": "Question",
"name": "Does FAQ schema improve SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "FAQ schema can improve your visibility in search results by adding expandable Q&A dropdowns to your listing. This increases your click-through rate and takes up more space on the results page."
}
}
]
}
A few things to notice:
- The
@contextis alwayshttps://schema.org. Don't change it. - The
@typeisFAQPage. This tells Google the page contains FAQ content. - Each question goes inside the
mainEntityarray as aQuestionobject. - Each question has an
acceptedAnswerwith atextfield containing the answer. - The
namefield holds the question text. Write it exactly as it appears on your page. - The
textfield in the answer can include basic HTML like links, lists, and bold text.
You can include as many questions as you need. There's no hard limit from Google, though keeping it relevant to your page content is important.
How to Add FAQ Schema Manually (Step by Step)
Step 1: Write Your FAQ Content on the Page
Before adding schema, make sure the questions and answers are visible on your page. Google requires that the FAQ content in your markup matches what visitors can see. Hidden content will get your schema ignored or flagged.
Step 2: Create Your JSON-LD Script
Write the JSON-LD block following the format above. Each question-answer pair from your page gets its own object in the mainEntity array. Match the text exactly to what's on the page.
Step 3: Add the Script to Your HTML
Place the JSON-LD inside a <script> tag with the type application/ld+json. It goes in the <head> section of your page:
<head>
<!-- your other meta tags -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Your question here?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Your answer here."
}
}
]
}
</script>
</head>
You can also place it just before the closing </body> tag. Google processes both locations the same way.
Step 4: Validate Your Markup
Before publishing, run your page through Google's Rich Results Test (more on that below). Fix any errors or warnings before going live.
Step 5: Publish and Request Indexing
Once validated, publish the page. Speed things up by submitting the URL through Google Search Console and requesting indexing.
Generate FAQ Schema Automatically with Morphkit
Writing JSON-LD by hand works, but it's tedious. One misplaced comma and the whole thing breaks. If you have multiple pages with FAQ sections, manual work adds up fast.
Morphkit's FAQ Generator builds both the FAQ content and valid JSON-LD schema for you. Type your topic, get structured questions and answers with the schema ready to paste into your HTML. No coding required.
It's useful for:
- Creating FAQ sections for service or product pages
- Generating schema for existing FAQ content
- Producing valid JSON-LD without worrying about syntax
If you need structured data for other types (like Article, LocalBusiness, or HowTo), the Schema Markup Generator covers those.
Testing with Google's Rich Results Test
Google provides a free tool at search.google.com/test/rich-results to validate your structured data.
You can test by pasting your live URL or your raw HTML code before publishing.
The tool shows whether your FAQ schema is valid, flags errors, and previews how your rich result will appear. Green checkmarks mean you're good. Warnings are worth fixing, they reduce your chances of getting featured.
Common issues it catches:
- Missing required fields (like
nameortext) - Incorrect
@typevalues - Malformed JSON (missing commas, extra brackets)
- Content mismatch between schema and visible page content
Run this test every time you add or update FAQ schema. It takes 30 seconds and saves you from waiting weeks to discover something was broken.
Common Mistakes to Avoid
Schema content doesn't match the page. Every question and answer in your JSON-LD must be visible on the page. If they don't match, your schema gets ignored.
Using FAQ schema on non-FAQ pages. A page with one question isn't an FAQ page. Google expects multiple questions in a genuine FAQ format. Don't force this schema onto every page.
Duplicate FAQ schema across pages. Using the same markup on multiple pages confuses search engines. Each page should have unique questions relevant to that page's content.
Broken JSON syntax. A missing comma, an extra bracket, an unclosed quote. Any of these will make the entire block invalid. Always validate before publishing.
Stuffing keywords into answers. Write answers for humans, not search engines. Keyword-stuffed answers hurt more than they help.
Forgetting to update schema when content changes. If you edit your FAQ section, update the JSON-LD to match. Stale schema is a mismatch Google will eventually catch.
Does FAQ Schema Still Work in 2026?
Yes, FAQ schema still works. But Google has become more selective about when it displays FAQ rich results.
In 2023, Google announced it would limit FAQ rich results to "well-known, authoritative government and health websites." That reduced visibility for many sites. Google has since adjusted its approach. In 2025 and 2026, FAQ rich results appear for a broader range of sites, though not as freely as before 2023.
Here's what matters now:
- Google shows FAQ rich results primarily for pages with high-quality, original FAQ content.
- Pages on established domains with good authority have better chances.
- The content must genuinely answer the questions. Thin or generic answers rarely get featured.
- Proper implementation still matters. Invalid schema never gets shown.
Even when Google doesn't display the rich result, valid FAQ schema helps search engines understand your page structure. That can improve how your page ranks for question-based queries, which are a growing share of searches.
Add FAQ schema to pages where you have genuine FAQ content. The upside is real and the downside is zero.
Quick Checklist
- Write visible FAQ content on your page first
- Generate JSON-LD with Morphkit's FAQ Generator or write it manually
- Place the script in your
<head>or before</body> - Test with Google's Rich Results Test
- Submit the URL for indexing in Search Console
- Keep schema and page content in sync when you make changes
Related Tools
Your FAQ is one piece of the SEO puzzle. Make sure the rest of your page is optimized too:
- Meta Tag Generator for title tags and meta descriptions
- Open Graph Tag Generator for social sharing previews
- Schema Markup Generator for Article, LocalBusiness, HowTo, and other schema types