Skip to content
SEOVault AISEOVault AI Docs

Product Schema for WooCommerce

SEOVault AI automatically generates Product schema markup for WooCommerce products. This schema helps search engines understand your product information for rich results in search listings.

How it works

Section titled “How it works”

SEOVault AI uses a V2 integration system to contribute Product schema for WooCommerce products. The schema:

  • Merges with WooCommerce’s native schema — Enhances rather than replaces WooCommerce’s built-in schema
  • Tags schema with integration source — Marks schema as coming from the WooCommerce integration
  • Supports both Product and ProductGroup types — Handles simple products and variable products
  • Automatically activates when WooCommerce is present — No manual configuration required

Schema types

Section titled “Schema types”

Product schema

Section titled “Product schema”

Generated for individual products and product variations. Includes:

  • @type — Product
  • @id — Schema identifier
  • name — Product name
  • description — Product description
  • image — Product image(s)
  • url — Product URL
  • sku — Product SKU
  • gtin — GTIN/MPN/ISBN (if configured)
  • brand — Brand information (if configured)
  • offers — Price, availability, and offer details
  • aggregateRating — Average rating (if reviews exist)
  • review — Individual reviews (if present)

ProductGroup schema

Section titled “ProductGroup schema”

Generated for variable products with multiple variations. Includes:

  • @type — ProductGroup
  • @id — Schema identifier
  • name — Product name
  • description — Product description
  • productGroupID — Group identifier
  • hasVariant — Array of variant Product schemas
  • variesBy — Attributes that vary (color, size, etc.)

Schema features

Section titled “Schema features”

Variation images

Section titled “Variation images”

SEOVault AI includes variation-specific images in the schema. Each variation can have its own image, which helps search engines display the correct product image in rich results.

How it works:

  • When a variation has a specific image, that image is included in the variation’s schema
  • If no variation image is set, the parent product image is used
  • Multiple images can be included for each product

Product attributes

Section titled “Product attributes”

Product attributes are automatically included in schema markup:

Default attributes included:

  • Color
  • Pattern
  • Material
  • Size

Custom attributes:

  • Additional attributes can be added via the seovaultseo_allowed_product_attributes filter
  • Attributes are mapped to schema.org property names

Return policy

Section titled “Return policy”

Return policy information is added to the organization schema when configured:

Includes:

  • Return policy URL
  • Return policy description
  • Return method (in-store, by mail, etc.)
  • Return days (e.g., 30-day return policy)

Product identifiers

Section titled “Product identifiers”

Product identifiers are included in schema when configured:

Supported identifiers:

  • GTIN-8, GTIN-12 (UPC), GTIN-13 (EAN), GTIN-14
  • MPN (Manufacturer Part Number)
  • ISBN (for books)

How it works:

  • The plugin checks the custom GTIN field first
  • Falls back to WooCommerce’s native global_unique_id field
  • Includes the identifier in the appropriate schema property

Integration with WooCommerce schema

Section titled “Integration with WooCommerce schema”

SEOVault AI is designed to work alongside WooCommerce’s native schema:

Merging behavior

Section titled “Merging behavior”
  • WooCommerce generates its own Product schema
  • SEOvault AI contributes additional schema data
  • The schemas are merged to create a comprehensive product representation
  • No data is lost or overwritten

Schema source tagging

Section titled “Schema source tagging”

Each schema contributed by SEOvault AI is tagged with:

  • source — Integration source identifier
  • source_ref — Unique reference including integration ID and product ID

This allows for schema validation and debugging.

Schema generation triggers

Section titled “Schema generation triggers”

Product schema is generated for:

  • Individual product pages
  • Product category pages (for featured products)
  • Product archive pages
  • Search results pages (for product results)

Schema is not generated for:

  • Cart pages
  • Checkout pages
  • My Account pages
  • Hidden products
  • Out-of-stock products (optional)

Testing product schema

Section titled “Testing product schema”

Google Rich Results Test

Section titled “Google Rich Results Test”

Use the Google Rich Results Test to verify your product schema:

  1. Enter your product page URL
  2. Review the detected Product schema
  3. Check for errors or warnings
  4. Verify all required fields are present

Schema.org validation

Section titled “Schema.org validation”

Use the Schema.org Validator to check schema compliance:

  1. Enter your product page URL
  2. Review validation results
  3. Fix any structural errors
  4. Ensure all properties are correctly typed

Google Search Console

Section titled “Google Search Console”

Monitor schema performance in Google Search Console:

  1. Go to Enhancements > Products
  2. Review valid and error items
  3. Fix any schema errors
  4. Monitor rich result performance

Required schema fields

Section titled “Required schema fields”

For Product schema to be valid, certain fields are required:

Minimum required

Section titled “Minimum required”
  • @type — Must be “Product”
  • name — Product name
  • image — At least one product image
  • description — Product description
Section titled “Recommended for rich results”
  • sku — Product SKU
  • gtin — Product identifier
  • brand — Brand information
  • offers — Price and availability
  • aggregateRating — Average rating
  • review — Customer reviews

Common issues and solutions

Section titled “Common issues and solutions”

Schema not appearing

Section titled “Schema not appearing”

Possible causes:

  • WooCommerce not active
  • Product not published
  • Product hidden from catalog
  • Schema validation errors
  • Conflict with other schema plugins

Solutions:

  1. Verify WooCommerce is active
  2. Check product status is “Published”
  3. Ensure product is not hidden
  4. Test with Rich Results Test
  5. Disable conflicting plugins

Missing variation images

Section titled “Missing variation images”

Possible causes:

  • No variation images set
  • Parent product image missing
  • Image URLs incorrect

Solutions:

  1. Set images for each variation
  2. Ensure parent product has a featured image
  3. Verify image URLs are accessible
  4. Check image permissions

Incorrect GTIN in schema

Section titled “Incorrect GTIN in schema”

Possible causes:

  • GTIN field empty
  • GTIN type mismatch
  • Using WooCommerce global_unique_id instead

Solutions:

  1. Enter GTIN in the SEOvault AI field
  2. Configure correct GTIN type
  3. Verify GTIN format matches type
  4. Test with Rich Results Test

Duplicate schema

Section titled “Duplicate schema”

Possible causes:

  • Multiple schema plugins active
  • WooCommerce and SEOvault AI both generating schema
  • Schema merge issues

Solutions:

  1. Disable conflicting schema plugins
  2. Use schema validation to identify duplicates
  3. Check integration source tags
  4. Ensure proper schema merging

Customization

Section titled “Customization”

Add custom attributes

Section titled “Add custom attributes”

Use the seovaultseo_allowed_product_attributes filter to add custom attributes:

add_filter( 'seovaultseo_allowed_product_attributes', function( $attributes ) {
    $attributes[] = 'weight';
    $attributes[] = 'dimensions';
    return $attributes;
} );

Modify schema data

Section titled “Modify schema data”

Use the seovaultseo_schema_integration_contributors filter to modify schema:

add_filter( 'seovaultseo_schema_integration_contributors', function( $contributors ) {
    // Modify contributors array
    return $contributors;
} );

Exclude specific products

Section titled “Exclude specific products”

Use the seovaultseo_should_output_seo filter to exclude products:

add_filter( 'seovaultseo_should_output_seo', function( $should_output ) {
    if ( is_product() && some_condition() ) {
        return false;
    }
    return $should_output;
} );

Best practices

Section titled “Best practices”

Use product identifiers

Section titled “Use product identifiers”

Add GTIN, MPN, or ISBN to all products:

  • Improves Google Shopping performance
  • Enhances rich product results
  • Helps with cross-platform inventory
  • Reduces product matching errors

Optimize product images

Section titled “Optimize product images”
  • Use high-quality images (minimum 800x800px)
  • Include multiple angles
  • Use white or neutral backgrounds
  • Ensure images are accessible
  • Use descriptive alt text

Write compelling descriptions

Section titled “Write compelling descriptions”
  • Use unique descriptions for each product
  • Include relevant keywords naturally
  • Highlight key features and benefits
  • Keep descriptions under 160 characters for meta display
  • Use WooCommerce short descriptions effectively

Encourage reviews

Section titled “Encourage reviews”
  • Request reviews from customers
  • Display reviews prominently
  • Respond to customer reviews
  • Use review schema for rich results
  • Monitor review ratings

Monitor performance

Section titled “Monitor performance”
  • Use Google Search Console to track schema errors
  • Monitor rich result click-through rates
  • Track product performance in search results
  • Update schema based on performance data
Section titled “Related docs”