FAQ (FAQPage
, Question
, Answer
) structured data

If your government-focused or health-focused site has a list of questions and answers, you can use
FAQPage
structured data to help people find that information on Google. Properly
marked up FAQ pages may be eligible to have a rich result on Search and an
Action on the Google Assistant, which
can help your site reach the right users.
Feature availability
FAQ rich results are only available for well-known, authoritative websites that are government-focused or health-focused. The feature is available on desktop and mobile devices in all countries and languages where Google Search is available.
How to add structured data
Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.
Here's an overview of how to build, test, and release structured data.
- Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
- Follow the guidelines.
- Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
- Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is
accessible to Google and not blocked by a robots.txt file, the
noindex
tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs. - To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.
Examples
Here's an example of FAQPage
in JSON-LD:
<html> <head> <title>Finding an apprenticeship - Frequently Asked Questions(FAQ)</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{ "@type": "Question", "name": "How to find an apprenticeship?", "acceptedAnswer": { "@type": "Answer", "text": "<p>We provide an official service to search through available apprenticeships. To get started, create an account here, specify the desired region, and your preferences. You will be able to search through all officially registered open apprenticeships.</p>" } }, { "@type": "Question", "name": "Whom to contact?", "acceptedAnswer": { "@type": "Answer", "text": "You can contact the apprenticeship office through our official phone hotline above, or with the web-form below. We generally respond to written requests within 7-10 days." } }] } </script> </head> <body> </body> </html>
Here's an example of FAQPage
in Microdata:
<html itemscope itemtype="https://schema.org/FAQPage"> <head></head> <body> <h1> Frequently Asked Questions(FAQ) </h1> <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question"> <h2 itemprop="name">How to find an apprenticeship?</h2> <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer"> <div itemprop="text"> We provide an official service to search through available apprenticeships. To get started, create an account here, specify the desired region, and your preferences. You will be able to search through all officially registered open apprenticeships. </div> </div> </div> <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question"> <h2 itemprop="name">Whom to contact?</h2> <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer"> <div itemprop="text"> You can contact the apprenticeship office through our official phone hotline above, or with the web-form below. We generally respond to written requests within 7-10 days. </div> </div> </div> </body> </html>
Guidelines
For your FAQ page to be eligible for FAQ rich results, you must follow these guidelines:
Content guidelines
- Your site must be a health or government site. It must also be well-known and authoritative.
- Only use
FAQPage
if your page contains FAQs where there's a single answer to each question. If your page has a single question and users can submit alternative answers, useQAPage
instead. Here are some examples:Valid use cases:
- An FAQ page written by the health site itself, with no way for users to submit alternative answers
- A government agency's support page that lists FAQs, with no way for users to submit alternative answers
Invalid use cases:
- A forum page where users can submit answers to a single question
- A product support page where users can submit answers to a single question
- A product page where users can submit multiple questions and answers on a single page
- Don't use
FAQPage
for advertising purposes. - Make sure each
Question
includes the entire text of the question and make sure eachAnswer
includes the entire text of the answer. The entire question text and answer text may be displayed. - Question and answer content may not be displayed as a rich result if it contains any of the following types of content: obscene, profane, sexually explicit, graphically violent, promotion of dangerous or illegal activities, or hateful or harassing language.
- All
FAQ
content must be visible to the user on the source page. Here are some examples:Valid use cases:
- Both the question and answer are visible on the page.
- The question is visible on the page, and the answer is hidden behind an expandable section. The user is able to access the answer by clicking the expandable section.
Invalid use cases: The user can't find the FAQ content on the page at all.
- If you have FAQ content that is repetitive on your site (meaning, the same question and answer appear on multiple pages on your site), mark up only one instance of that FAQ for your entire site.
Structured data type definitions
You must include the required properties for your content to be eligible for display as a rich result. You can also include the recommended properties to add more information to your structured data, which could provide a better user experience.
FAQPage
The full definition of FAQPage is provided on schema.org.
The FAQPage
type indicates that the page is an FAQ with answered questions. There
must be one FAQPage
type definition per page.
The Google-supported properties are the following:
Required properties | |
---|---|
mainEntity |
Question
An array of |
Question
The full definition of Question
is
provided on schema.org.
The Question
type defines a single answered question within the FAQ. Every
Question
instance must be contained within the mainEntity
property array
of the schema.org/FAQPage
.
The Google-supported properties are the following:
Required properties | |
---|---|
acceptedAnswer |
Answer
The answer to the question. There must be one answer per question. |
name |
Text
The full text of the question. For example, "How long does it take to process a refund?". |
Answer
The full definition of Answer
is
provided on schema.org.
The Answer
type defines the acceptedAnswer
to each of the
Question
on this page.
The Google-supported properties are the following:
Required properties | |
---|---|
text |
Text
The full answer to the question. The answer may contain HTML content such as links and
lists. Google Search displays the following HTML tags:
|
Monitor rich results with Search Console
Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:
- After deploying structured data for the first time
- After releasing new templates or updating your code
- Analyzing traffic periodically
After deploying structured data for the first time
After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:
- Fix the invalid items.
- Inspect a live URL to check if the issue persists.
- Request validation using the status report.
After releasing new templates or updating your code
When you make significant changes to your website, monitor for increases in structured data invalid items.- If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
- If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.
Analyzing traffic periodically
Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.问题排查
如果您在实施或调试结构化数据时遇到问题,请查看下面列出的一些实用资源。
- 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站,请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
- Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因,请参阅结构化数据常规指南。
- 您的结构化数据可能存在错误。请查看结构化数据错误列表和“无法解析的结构化数据”报告。
- 如果您的网页受到结构化数据手动操作的影响,其中的结构化数据将会被忽略(但该网页仍可能会出现在 Google 搜索结果中)。如需修正结构化数据问题,请使用“人工处置措施”报告。
- 再次查看相关指南,确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过,问题可能不是语法问题,因此富媒体搜索结果测试无法识别这些问题。
- 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
- 请等待一段时间,以便 Google 重新抓取您的网页并重新将其编入索引。请注意,网页发布后,Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题,请参阅 Google 搜索抓取和索引编制常见问题解答。
- 在 Google 搜索中心论坛中发帖提问。