variesBy

A Schema.org Property

Usage: (Google - August 2026)

This term is in the "new" area - implementation feedback and adoption from applications and websites can help improve our definitions.

Thing > Property :: variesBy

[more...]

Canonical URL: https://schema.org/variesBy
Check for open issues.

Indicates the property or properties by which the variants in a ProductGroup vary, e.g. their size, color etc. Schema.org properties can be referenced by their short name e.g. "color"; terms defined elsewhere can be referenced with their URIs.

Values expected to be one of these types


                
                    
                        
    
    
    DefinedTerm
                    
                
                    
                        
    
    
    Text

Used on these types


                
                    
                        
    
    
    ProductGroup

Examples

Example 1

No Markup JSON-LD Structure

Example notes or example HTML without markup.

Markup snippet illustrating how to provide various variant dimensions (both native and non-native Schema.org properties) using PropertyValue to specify ranges of available values.

Example encoded as JSON-LD in a HTML script tag.

<script type="application/ld+json">

{
  "@context": "https://schema.org/",
  "@type": "ProductGroup",
  "variesBy": [
    {
      "@type": "PropertyValue",
      "name": "color",
      "value": ["black", "silver"]
    },
    {
      "@type": "PropertyValue",
      "name": "material",
      "value": ["plastic", "aluminum"]
    },
    {
      "@type": "PropertyValue",
      "name": "Memory size",
      "value": [16, 32, 64],
      "unitCode": "E34",
      "unitText": "GB"
    },
    {
      "@type": "PropertyValue",
      "name": "CPU",
      "value": ["low_8core", "high_16core"]
    },
    {
      "@type": "PropertyValue",
      "name": "size",
      "value": [
        {
          "@type": "SizeSpecification",
          "name": ["XS", "S"],
          "sizeSystem": "https://schema.org/WearableSizeSystemUS",
          "sizeGroup": "https://schema.org/WearableSizeGroupPetite"
        },
        {
          "@type": "SizeSpecification",
          "name": ["M", "L"],
          "sizeSystem": "https://schema.org/WearableSizeSystemUS",
          "sizeGroup": "https://schema.org/WearableSizeGroupRegular"
        },
        {
          "@type": "SizeSpecification",
          "name": "XL",
          "sizeSystem": "https://schema.org/WearableSizeSystemUS",
          "sizeGroup": "https://schema.org/WearableSizeGroupPlus"
        },
        {
          "@type": "SizeSpecification",
          "name": ["XXL", "XXXL"],
          "sizeSystem": "https://schema.org/WearableSizeSystemUS",
          "sizeGroup": "https://schema.org/WearableSizeGroupBig"
        }
      ]
    }
  ]
}

 </script>

Structured representation of the JSON-LD example.

variesBy

Values expected to be one of these types

Used on these types

Source

Examples