Troubleshooting Rich Snippets Suite Issues

• Module Enabled: Magmodules → Rich Snippets Suite → General → Enabled = Yes
• Schema Enabled: Each schema type (Product, Organization, etc.) has its own Enable switch
• Cache Cleared: Run bin/magento cache:flush after configuration changes

1. Visit a product page on your storefront
2. Right-click → View Page Source
3. Search for application/ld+json
4. If not found, check configuration above

Some themes or extensions may remove or modify the structured data:

1. Enable Advanced → Remove Theme Snippets to clean theme markup
2. Check for JavaScript that manipulates <script> tags
3. Test in a different browser without extensions

• Google doesn't show rich results immediately
• It can take days to weeks for Google to process and display
• Not all pages are guaranteed to show rich results

1. Go to Rich Results Test
2. Enter your product page URL
3. Check for errors (red) and warnings (yellow)
4. Fix any issues found

"Missing field 'priceValidUntil'"

• Configure Price Valid Until Mode in Product schema settings
• Set a custom fallback or use special price dates

"Missing field 'review'"

• This is a warning, not an error
• Products without reviews won't have review data
• Consider enabling "Add Separate Review(s)" when reviews exist

"Missing field 'brand'"

• Map your brand attribute in Schema: Products → Attributes → Brand
• Use Manufacturer attribute or create a dedicated brand attribute

"Image should be at least 1200 pixels wide"

• Use larger product images
• Google prefers high-resolution images for rich results

Your theme may output its own structured data:

1. Enable Advanced → Remove Theme Snippets
2. Clear cache
3. Revalidate in Rich Results Test

If you have multiple SEO extensions:

1. Disable structured data in other extensions
2. Use only Rich Snippets Suite for all schema output
3. Check for conflicting markup in page source

Search page source for multiple "@type": "Product" entries:

• There should be one Product schema per simple product
• Configurable products may have ProductGroup + variants (this is correct)

• Ratings require at least one approved review
• Products without reviews won't show aggregateRating

• Check Rating Source in Product schema settings
• Ensure selected source (Native or third-party) has reviews

• Verify Display Rating is set to Yes
• Check that Rating Source is properly configured

• Enable Split Configurable Products Snippets
• Select Use Variants mode
• Configure which attributes to inherit from parent

• Enable Use reviews from parent product
• Reviews are typically collected on parent products

• Check Use Parent Data for Simples settings
• Remove "Image" from parent inheritance if variants have unique images

1. Go to Marketing → Rich Snippets → Local Business
2. Add at least one location with complete information
3. Enable LocalBusiness schema in configuration

Google requires for LocalBusiness:

• Business name
• Address (street, city, postal code, country)
• Coordinates (latitude, longitude)

• Check Local Business setting in configuration
• Select "All" or choose specific locations

1. Go to Marketing → Rich Snippets → Shipping Details
2. Add shipping configurations per country
3. Enable Shipping Details schema

Each entry needs:

• Country
• Shipping price and currency
• Handling time (min/max)
• Transit time (min/max)

• Enable OpenGraph/Twitter in Additional Markup section
• Different page types have separate switches (Product, Category, CMS)

• OpenGraph uses the store logo from Store Information
• Product pages use the product image
• Ensure images meet minimum size requirements

• Enter your Twitter username for proper Twitter Card attribution
• Format: @username or just username

Structured data generation is cached. If experiencing slowness:

1. Ensure Magento caches are enabled
2. Check for excessive "Extra Attributes" in Product schema
3. Large numbers of reviews (100+) may impact performance

bin/magento cache:clean
bin/magento cache:flush

• Check for full-page cache (Varnish) excluding JSON-LD scripts
• Verify same configuration in production
• Clear all caches after deployment

• Run bin/magento setup:upgrade
• Clear cache
• Check if configuration was reset

• Rich Results Test fetches live URL
• Ensure page is accessible (no authentication, not blocked by robots.txt)
• Check if CDN is serving stale content