Angeo Rich Data — Magento 2

Fixes the "Product schema — JSON-LD structured data" signal in angeo/module-aeo-audit. Injects spec-compliant JSON-LD on product pages, CMS pages, and homepage.

What this module fixes

Schema types injected

Installation

composer require angeo/module-rich-data
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

Stores → Configuration → Angeo → Rich Data (JSON-LD)

Product schema

• Enable/disable
• Include AggregateRating (from Magento reviews)
• Include BreadcrumbList
• Include SKU
• Include Brand (configurable attribute)
• Include GTIN / MPN (configurable attributes)
• Item condition (New/Used/Refurbished)
• In-stock / out-of-stock availability URLs

Merchant policies (return & shipping)

Injects offers.hasMerchantReturnPolicy and offers.shippingDetails — required by Google & ChatGPT Shopping since Jan 2026. Disabled by default; enable and fill in your real values.

• Return policy: enable, return window (days), applicable country, return fee
• Shipping details: enable, flat shipping rate, destination country, handling time (min/max days), transit time (min/max days)

Organization schema

• Organization name (default: store name)
• Logo URL
• sameAs social URLs (comma-separated)
• Contact telephone + type

WebSite schema

• Enable/disable
• Include SearchAction (Sitelinks Searchbox)

FAQPage schema

• Enable/disable — auto-detected from CMS page content

FAQ page markup (recommended)

Add data-faq-question / data-faq-answer attributes to your CMS FAQ page for explicit Q&A detection:

<div data-faq-question="What is your return policy?"
     data-faq-answer="We offer 30-day returns on all items in original condition.">
</div>

Without these attributes the module uses heuristic detection: <h2>/<h3> followed by <p> are treated as question/answer pairs.

Extending with custom schemas

Implement Angeo\RichData\Api\Data\SchemaInterface and register via di.xml:

<type name="Angeo\RichData\Model\JsonLd\Renderer\SchemaRenderer">
    <arguments>
        <argument name="builders" xsi:type="array">
            <item name="my_schema" xsi:type="object">Vendor\Module\Model\JsonLd\Builder\MySchemaBuilder</item>
        </argument>
    </arguments>
</type>

CLI validation

# Validate on random product
bin/magento angeo:rich-data:validate --store=en_us

# Validate specific product on specific store
bin/magento angeo:rich-data:validate --store=en_us --product-id=42

Output example:

Validating JSON-LD for: [42] Alpine Hiking Jacket
  Store:   default
  URL:     https://mystore.com/alpine-jacket

Found 3 JSON-LD block(s):
  Block 1: @type:Organization — valid JSON ✓
  Block 2: @type:Product — valid JSON ✓
    PASS aggregateRating present
  Block 3: @type:BreadcrumbList — valid JSON ✓

All JSON-LD blocks are valid.

The Angeo AI Suite

License

MIT — see LICENSE

Changelog

All notable changes to angeo/module-rich-data are documented here.
This project adheres to Semantic Versioning.

[1.2.0] - 2026-06-13

Added

• CollectionPage + ItemList on category pages (CollectionPageBuilder).
  Emits a CollectionPage whose mainEntity is an ItemList of the category's
  enabled, catalog-visible products (capped at 50). Read by the Gemini Shopping
  Graph, which previously had no machine-readable product listing on category
  pages. Toggle under Angeo Rich Data → CollectionPage schema (on by default).
• Organization description. The Organization schema now includes a
  description field (configurable under Angeo Rich Data → Organization →
  Organization description). AI engines read it as the brand entity summary;
  its absence was previously flagged by the AEO audit.

Changed

• ViewModel\JsonLd now builds context for catalog_category_view (current
  category + a lightweight product list) so the new CollectionPage builder has
  data to render.

[1.1.0] - 2026-06-08

Added

• Merchant return policy (offers.hasMerchantReturnPolicy). Emits a
  spec-compliant MerchantReturnPolicy (applicableCountry, merchantReturnDays,
  returnPolicyCategory, returnMethod, returnFees). Required by Google &
  ChatGPT Shopping since January 2026. Configurable under
  Stores → Configuration → Angeo → Rich Data → Merchant policies.
• Shipping details (offers.shippingDetails). Emits OfferShippingDetails
  with shippingRate (MonetaryAmount), shippingDestination (DefinedRegion)
  and optional deliveryTime (handling + transit QuantitativeValue).
• GTIN / MPN identifiers on Product schema, read from configurable product
  attributes. Improves AI/Google product matching. Off by default.
• New admin config group Merchant policies (return & shipping) and new
  Product fields: Include GTIN/MPN, GTIN attribute, MPN attribute, In-stock
  availability URL, Out-of-stock availability URL.
• Model/Config/Source/ReturnFee source model for the return-fee dropdown.
• Unit coverage for the merchant return policy and shipping details output.

Fixed

• BreadcrumbList now actually renders on product pages. The
  BreadcrumbBuilder expected a breadcrumbs context key that the ViewModel
  never supplied, so the breadcrumb schema silently never appeared even with
  the toggle enabled. The ViewModel now builds the full trail
  (Home → category path → product) from the product's deepest active category
  and passes it into the render context. This resolves the persistent
  "BreadcrumbList missing" finding in angeo/module-aeo-audit.
• availability_in_stock / availability_out_of_stock are now exposed in the
  admin (previously only present as config.xml defaults and not editable). The
  builder also falls back to sane schema.org defaults if either value is blank.

Changed

• ViewModel now logs render failures via LoggerInterface instead of silently
  swallowing them, matching the error handling already used in SchemaRenderer.

Migration notes

• No schema or data migration required. After upgrading, run:

  bin/magento setup:upgrade
  bin/magento cache:flush
  

• Merchant return policy and shipping details are disabled by default to
  avoid publishing inaccurate policy data. Enable and fill them in under
  Stores → Configuration → Angeo → Rich Data → Merchant policies once your
  real return window, shipping rate and delivery times are known. Publishing
  incorrect policy values can hurt eligibility, so opt in deliberately.

[1.0.2] - 2026-04-18

Added

• Initial public release: Product, Organization, WebSite, BreadcrumbList and
  FAQPage JSON-LD builders, admin configuration, angeo:rich-data:validate
  CLI command, and unit tests.