Digital Technology, Decoded
Subscribe
Web Design

ACF 6.8 Schema.org Mapping: Recipe, Product, Event, and Article Worked Examples

ACF 6.8 Schema.org mapping in WordPress: four worked structured-data examples that show how to map an Advanced Custom Fields field group to a Schema.org type using the new schema mapping pane that ships in ACF 6.8, covering the Recipe type (with prepTime cookTime recipeYield recipeIngredient and recipeInstructions properties), the Product type (with offers brand sku review and aggregateRating properties), the Event type (with startDate location organizer and offers properties), and the Article type (with headline author datePublished and image properties), plus the JSON-LD output that ACF generates from each mapping and the validation patterns for confirming the output against the Schema Markup Validator and Google's Rich Results Test.
Adams V. 15 min read
FacebookX

ACF 6.8, released in April 2026, added a Schema.org mapping pane to field groups. The pane lets a developer declare which Schema.org type a field group represents and map individual fields to specific Schema.org properties. ACF then generates the appropriate JSON-LD output on the front end without the developer writing the JSON-LD generation code by hand. The feature is the third major ACF 6.8 addition (alongside the Abilities API integration and the schema-aware field types), and it is the one that most directly addresses the rising importance of structured data for AI-mediated discoverability through search engines and AI Overviews.

This piece walks through four worked examples that cover the most common Schema.org types used by WordPress sites: Recipe, Product, Event, and Article. Each example shows the ACF field group, the Schema.org mapping configuration, the JSON-LD output ACF generates, and the validation pattern. The examples are written so that a developer can follow them step by step and produce equivalent output on their own site. The patterns generalize to other Schema.org types that ACF 6.8 supports, which includes the full Schema.org Core vocabulary as of the 25.0 release.

How the schema mapping pane works

When you create or edit an ACF field group in WordPress 6.7+ with ACF 6.8 installed, a new tab appears in the field group settings called "Schema mapping." Inside this tab you can select a Schema.org type from a searchable dropdown. The dropdown contains every type in the Schema.org Core vocabulary, organized by category (Creative Works, Products, Events, Organizations, People, Places). Selecting a type populates a properties list showing the Schema.org properties defined for that type. Each property has a dropdown letting you bind it to one of the fields in your group, or leave it unbound.

For each binding, you can optionally specify a transformation. The default transformation is identity (the field value is the property value), but you can choose alternatives like "ISO 8601 duration" (for time fields), "ISO 8601 date" (for date fields), "URL" (for URL fields), "structured array" (for nested properties), or "callback" (for custom transformations via a PHP function).

When the page rendering pipeline reaches a post or term that has fields from a mapped group, ACF generates a JSON-LD