Structured Data (Schema) in GT ACF Blocks

Overview

Several blocks output JSON-LD structured data in <script type="application/ld+json"> tags. This helps search engines understand your content and can enable rich results in search listings.

Several blocks output JSON-LD structured data automatically: FAQ schema from accordions, product data from product boxes, and more. The schema renders in script tags alongside the block, which means rich-result eligibility without an extra SEO plugin doing the markup.

Accordion Block – FAQPage Schema

When the “Enable FAQ Schema” toggle is turned on, the accordion block outputs FAQPage schema. Each accordion item becomes a Question with an acceptedAnswer.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is this plugin?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "A collection of ACF blocks..."
      }
    }
  ]
}

The schema is only output on the frontend (not in editor previews).

Product Review – Product Schema

The product review block outputs a comprehensive Product schema. A Product Type field switches the type to SoftwareApplication for apps and SaaS (adding applicationCategory and operatingSystem). The schema includes:

• Review with author, reviewBody, and reviewRating
• Offer with price, priceCurrency, and availability. Offers are always generated (price defaults to "0" when empty) so Google Search Console never flags a missing price.
• hasMerchantReturnPolicy from the Return Policy field (no returns, finite window with configurable days, or unlimited)
• shippingDetails from the Delivery Type field (digital products get zero-cost instant delivery) and the Shipping Country field
• positiveNotes (pros) and negativeNotes (cons) as ItemList objects
• aggregateRating if ratings are provided
• image, falling back to the post’s featured image when no product image is set

This schema can produce rich review snippets in Google Search results. The return policy, shipping, and image fallback fields exist specifically to clear the four structured-data warnings GSC used to raise on review pages.

Star Rating – AggregateRating Schema

The star rating block outputs AggregateRating schema based on submitted user ratings. The @type of the parent object is configurable from the block settings:

• Article
• BlogPosting
• CreativeWork
• Product
• (and others)

The schema includes ratingValue (the average) and ratingCount (total number of submissions).

Table of Contents – ItemList Schema

The TOC block outputs ItemList with SiteNavigationElement typed items. Each heading linked in the table of contents becomes a ListItem with a url pointing to the heading’s anchor.

Best Practices

• Only enable FAQ schema on pages that genuinely answer questions. Google may ignore FAQ schema if overused.
• Product review schema should reflect real editorial reviews, not user-generated content.
• The star rating schema is appropriate for content rating (blog posts, articles). For product ratings, pair it with the product review block instead.
• Validate your structured data using Google’s Rich Results Test after adding blocks with schema support.

Quick answers to common questions: