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

This guide lists common Google Rich Result warnings and errors you may see in the Rich Results Test or Search Console when using the Magmodules Rich Snippet Suite. Each entry explains the issue and how to fix it within your plugin configuration.

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.

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

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

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

Direct Help

At Magmodules, our support team is here to help you every step of the way. If you can't find a solution in our Knowledgebase, simply fill in the form below. We are in the Central European Timezone, and all your details are securely sent to us.

The more information you provide, the better we can assist you. Trust us to guide you through any challenge and ensure a seamless experience with our products and services.

Support by e-mail contact@magmodules.eu

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

Errors & Warnings Guide

1. Product Schema Issues

2. BreadcrumbList Schema

3. Organization & Website Schema

4. Category (ItemList) Schema

5. Global Issues

Verification Steps

Direct Help

The Magento and Shopware
development firm

Quick Links

Last Update Plugins

Pages

Reviews Plugins

Accounting Plugins

Marketplace Plugins

Company

Support

Office Hours

GitHub