Product Variants Example

This page demonstrates ProductGroup structured data with product variants. The structured data helps Google understand which products are variations of the same parent product.

Example: Training Course Packages

The example below shows three package variants (Basic, Premium, Complete) that vary by:

• Size: Basic, Premium, Complete
• Material: Digital, Hybrid

Single-Page Implementation

This example uses a single-page approach where all variants are selectable on the same page (usually via query parameters like ?package=basic&type=digital).

Note: This page handles query parameter variations gracefully. Abbreviations like "digi" (for digital) and "hy" (for hybrid) are automatically normalized to their full forms.

Nested Variants Structure

This example uses the nested variant structure (hasVariant), which is the recommended approach as it's more compact and natural.

Package Variants

Code Example

import { generateProductGroupSchema } from '@/lib/seo';

const productGroupSchema = generateProductGroupSchema({
  name: 'Biomagnetism Training Course Package',
  productGroupID: 'BMT-PKG-001',
  variesBy: [
    'https://schema.org/size',
    'https://schema.org/material',
  ],
  siteType: 'single-page',
  variantStructure: 'nested',
  variants: [
    {
      sku: 'BMT-PKG-001-BASIC',
      name: 'Biomagnetism Training - Basic Package',
      image: COURSE_IMAGES.online.primary,
      url: 'https://biomagnetismtherapytraining.com/product-variants-example?package=basic&type=digital',
      size: 'Basic',
      material: 'Digital',
      offers: {
        price: 695,
        priceCurrency: 'USD',
        availability: 'https://schema.org/InStock',
        url: 'https://biomagnetismtherapytraining.com/product-variants-example?package=basic&type=digital',
      },
    },
    // ... more variants
  ],
});

Testing

To test this implementation:

1. Use Google Rich Results Test to validate the structured data
2. Check that all variants are properly nested under ProductGroup
3. Verify that each variant has a unique SKU
4. Ensure all required properties are present
5. Test with Google Search Console URL Inspection tool
6. Try different query parameter combinations (including abbreviations like "digi" and "hy")

Query Parameter Handling

This page demonstrates robust query parameter handling:

• Normalization: Abbreviations are automatically normalized (digi → digital, hy → hybrid)
• Error Handling: Invalid parameters show a helpful message instead of crashing
• Visual Feedback: Selected variant is highlighted when query parameters match
• SEO-Friendly: All variant URLs are included in structured data for proper indexing