Skip to main content

Pages with FAQ Structured Data Errors

Priority: Low

Impact: Negative

What issues it may cause​

Pages with FAQ errors have improperly formatted question-and-answer content that search engines cannot interpret correctly.

How do you fix it​

  • Ensure all required properties are present: mainEntity array with Questions, name (full question text), acceptedAnswer, and text (complete answer)

  • Verify that all FAQ content is visible on the page, either displayed directly or behind expandable sections

  • Check that each Question includes the entire question text and each Answer includes the complete answer content

  • Avoid marking up repetitive FAQ content across multiple pages—mark up only one instance per question

Follow Google's FAQ guidelines for complete requirements

What is the positive impact​

FAQ structured data is properly interpreted by search engines and correctly represents question-and-answer content. For eligible government and health websites, valid markup enables questions with expandable answers to appear in search results.

How to fetch the data for this report template​

You will need to run a crawl for report template to generate report. When report has been generated and you have crawl id you can fetch data for the report using the following query:

Operation: query GetReportStatForCrawl( $crawlId: ObjectID! $reportTemplateCode: String! $after: String ) { getReportStat( input: {crawlId: $crawlId, reportTemplateCode: $reportTemplateCode} ) { crawlStructuredDataBlocks(after: $after, reportType: Basic) { nodes { url schemaType issuesSummary blockCount errorCount warningCount validationResult issues } totalCount pageInfo { endCursor hasNextPage } } } }Variables: {"crawlId":"TjAwNUNyYXdsNDAwMA","reportTemplateCode":"pages_with_faq_schema_issues"}
GetReportStatForCrawlTry in Explorer
GraphQL
query GetReportStatForCrawl(
    $crawlId: ObjectID!
    $reportTemplateCode: String!
    $after: String
   ) {
      getReportStat(
        input: {crawlId: $crawlId, reportTemplateCode: $reportTemplateCode}
      ) {
        crawlStructuredDataBlocks(after: $after, reportType: Basic) {
          nodes {
            url
            schemaType
            issuesSummary
            blockCount
            errorCount
            warningCount
            validationResult
            issues
          }
          totalCount
          pageInfo {
            endCursor
            hasNextPage
          }
        }
     }
   }