Rich Snippet Suite (Magento 2) – Errors & Warnings Guide

1. Product Schema Issues

Missing field "name", "image", "offers", or "price" (Error)

Google requires each Product schema to include `name`, `image`, and `offers` with `price`, `priceCurrency`, and `availability`. - Ensure your product has a name, image, and price in Magento. - In **Stores → Configuration → Magmodules → Rich Snippet Suite → Product Schema**: - Set *Enable Product Schema* = Yes - Confirm *Offer Type* = Single Offer (for simple products) or Aggregate Offer (for configurables) - Enable *Include Price* and *Availability* fields - Re-index and re-test the product URL in the [Rich Results Test](https://search.google.com/test/rich-results).

Missing field "brand", "sku", "gtin", or "mpn" (Warning)

Google recommends including product identifiers and brand information to improve search appearance. - In **Rich Snippet Suite → Attribute Mapping**: - Map the Magento attribute *manufacturer* or *brand* to **Brand**. - Map *sku* to **SKU**. - If available, map GTIN or MPN attributes. - Save configuration and clear cache.

Missing field "priceValidUntil" (Warning)

The `priceValidUntil` property is optional and used only for time-limited offers. - If you run promotions with an end date: - Set **Special Price To** in the product’s Advanced Pricing tab. - Enable *Include Price Valid Until* in the plugin configuration. - Otherwise, this warning can be safely ignored.

Invalid value for "price" or "availability" (Error)

Google only accepts valid schema.org values. For example, `availability` must use `https://schema.org/InStock`. - In the plugin: - Set **Availability Source** = Use Magento Stock Status - Ensure **Currency** matches your store’s ISO 4217 code (e.g. EUR, USD) - Re-test in Rich Results Tool.

Image resolution too small (Warning)

Google prefers images at least 1200px wide for product schema. - Upload higher-resolution images for your products. - Ensure the **Base Image** is selected and visible in the plugin’s JSON-LD output.

Missing "aggregateRating" or "review" (Warning)

Reviews and ratings must be user-generated and visible on the product page. - In the plugin: - Enable **Include Reviews** only if reviews are displayed on the frontend. - Ensure Magento reviews are enabled in **Stores → Configuration → Catalog → Reviews**. - Each review must include `author`, `ratingValue`, and `datePublished`.

Multiple Product items on one page (Error)

Google only expects one primary Product schema per product page. - Disable duplicate schema in your theme: - Set **Remove Theme Schema** = Yes in plugin settings. - Ensure no other extensions output product JSON-LD.

## 2. BreadcrumbList Schema

Missing "item", "name", or "position" (Error)

Each breadcrumb element must contain an item URL, name, and position. - Enable **Breadcrumb Schema** in the plugin configuration. - Check your theme’s breadcrumbs for correct ordering.

## 3. Organization & Website Schema

Logo not crawlable or too small (Warning)

The organization logo must be accessible to Google and large enough. - Upload your logo to a public path (e.g., `/pub/media/logo/`). - In the plugin: - Go to **Organization Schema** - Set **Logo URL** to the public image path

Missing SearchAction (Website schema)

The SearchAction property helps Google display a search box in results. - Enable **Website Schema** in plugin configuration. - Set **Search URL Pattern** to `?q={search_term_string}`.

## 4. Category (ItemList) Schema

Missing or invalid "itemListElement" (Warning)

ItemList schema describes category and listing pages. - Enable **ItemList Schema** for Category Pages in plugin config. - Ensure each product has a valid canonical URL.

## 5. Global Issues

Inconsistent structured data and visible content

Values in the JSON-LD must match what’s shown on the product page. - Check that price, name, and stock shown to users match schema output. - Ensure *Dynamic Values* in plugin settings are synced with frontend templates.

Invalid date format or relative URLs

Dates must be in ISO 8601 format and URLs must be absolute. - Use YYYY-MM-DD format for `datePublished` and `priceValidUntil`. - Confirm that all schema URLs are full, canonical links.

## Verification Steps

1. Go to Rich Results Test
2. Enter the product or category URL
3. Confirm all “Required fields” are valid (green)
4. Warnings can remain if optional fields are not relevant

Tip: Always clear Magento cache and re-index after updating schema configuration.