Note: you are viewing the development version of Schema.org. See How we work for more details.

SizeSpecification

A Schema.org Enumeration Type

This term is proposed for full integration into Schema.org, pending implementation feedback and adoption from applications and websites.
Size related properties of a product, typically a size code (name) and optionally a sizeSystem, sizeGroup, and product measurements (hasMeasurement). In addition, the intended audience can be defined through suggestedAge, suggestedGender, and suggested body measurements (suggestedMeasurement).
PropertyExpected TypeDescription
Properties from SizeSpecification
hasMeasurement QuantitativeValue A product measurement, for example the inseam of pants, the wheel size of a bicycle, or the gauge of a screw. Usually an exact measurement, but can also be a range of measurements for adjustable products, for example belts and ski bindings.
sizeGroup SizeGroupEnumeration  or
Text
The size group (also known as "size type") for a product's size. Size groups are common in the fashion industry to define size segments and suggested audiences for wearable products. Multiple values can be combined, for example "men's big and tall", "petite maternity" or "regular"
sizeSystem SizeSystemEnumeration  or
Text
The size system used to identify a product's size. Typically either a standard (for example, "GS1" or "ISO-EN13402"), country code (for example "US" or "JP"), or a measuring system (for example "Metric" or "Imperial").
suggestedAge QuantitativeValue The age or age range for the intended audience or person, for example 3-12 months for infants, 1-5 years for toddlers.
suggestedGender GenderType  or
Text
The suggested gender of the intended person or audience, for example "male", "female", or "unisex".
suggestedMeasurement QuantitativeValue A suggested range of body measurements for the intended audience or person, for example inseam between 32 and 34 inches or height between 170 and 190 cm. Typically found on a size chart for wearable products.
Properties from QualitativeValue
additionalProperty PropertyValue A property-value pair representing an additional characteristics of the entitity, e.g. a product feature or another characteristic for which there is no matching property in schema.org.

Note: Publishers should be aware that applications designed to use specific schema.org properties (e.g. https://schema.org/width, https://schema.org/color, https://schema.org/gtin13, ...) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism.
equal QualitativeValue This ordering relation for qualitative values indicates that the subject is equal to the object.
greater QualitativeValue This ordering relation for qualitative values indicates that the subject is greater than the object.
greaterOrEqual QualitativeValue This ordering relation for qualitative values indicates that the subject is greater than or equal to the object.
lesser QualitativeValue This ordering relation for qualitative values indicates that the subject is lesser than the object.
lesserOrEqual QualitativeValue This ordering relation for qualitative values indicates that the subject is lesser than or equal to the object.
nonEqual QualitativeValue This ordering relation for qualitative values indicates that the subject is not equal to the object.
valueReference DefinedTerm  or
Enumeration  or
MeasurementTypeEnumeration  or
PropertyValue  or
QualitativeValue  or
QuantitativeValue  or
StructuredValue  or
Text
A secondary value that provides additional information on the original value, e.g. a reference temperature or a type of measurement.
Properties from Enumeration
supersededBy Class  or
Enumeration  or
Property
Relates a term (i.e. a property, class or enumeration) to one that supersedes it.
Properties from Thing
additionalType URL An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
alternateName Text An alias for the item.
description Text A description of the item.
disambiguatingDescription Text A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
identifier PropertyValue  or
Text  or
URL
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details.
image ImageObject  or
URL
An image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPage CreativeWork  or
URL
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
Inverse property: mainEntity
name Text The name of the item.
potentialAction Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
sameAs URL URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
subjectOf CreativeWork  or
Event
A CreativeWork or Event about this Thing.
Inverse property: about
url URL URL of the item.

Instances of SizeSpecification may appear as a value for the following properties
PropertyOn TypesDescription
size CreativeWork  or
Product
A standardized size of a product or creative work, specified either through a simple textual string (for example 'XL', '32Wx34L'), a QuantitativeValue with a unitCode, or a comprehensive and structured SizeSpecification; in other cases, the width, height, depth and weight properties may be more applicable.

Source

https://github.com/schemaorg/schemaorg/issues/2811


Examples

Example 1
Copied
Example notes or example HTML without markup.
Complete example for a men's jacket with comprehensive size specification:
- Size system: US
- Size group: Men's Big & Tall
- Size code: 3XL
- Jacket measurements: chest: 52 inches, and length 42 inches.
- Suggested age group: 13 years and up
- Suggested body measurements: chest: 51-54 inches; height: 6-6.3 feet
Example encoded as Microdata embedded in HTML.
<!-- JSONLD only example -->
Example encoded as RDFa embedded in HTML.
<!-- JSONLD only example -->
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "sku": "44E01-M11000",
  "inProductGroupWithID": "44E01",
  "gtin14": "98766051104218",
  "image": "https://www.example.com/jacket_large_green.jpg",
  "name": "Large green jacket",
  "description": "Large wool green jacket for the winter months",
  "brand": {
    "@type": "Thing",
    "name": "A fashion brand"
  },
  "color": "green",
  "size": {
    "@type": "SizeSpecification",
    "sizeSystem": "https://schema.org/WearableSizeSystemUS",
    "sizeGroup": [
      "https://schema.org/WearableSizeGroupMens",
      "https://schema.org/WearableSizeGroupBig",
      "https://schema.org/WearableSizeGroupTall"
    ],
    "name": "3XL",
    "hasMeasurement": [
      {
        "@type": "QuantitativeValue",
        "valueReference": "https://schema.org/WearableMeasurementChest",
        "unitCode": "INH",
        "value": 52
      },
      {
        "@type": "QuantitativeValue",
        "valueReference": "https://schema.org/WearableMeasurementLength",
        "unitCode": "INH",
        "value": 42
      }
    ],
    "suggestedGender": "male",
    "suggestedAge": {
      "@type": "QuantitativeValue",
      "name": "adult",
      "unitCode": "ANN",
      "minValue": 13
    },
    "suggestedMeasurement": [
      {
        "@type": "QuantitativeValue",
        "valueReference": "https://schema.org/BodyMeasurementChest",
        "unitCode": "INH",
        "minValue": 51,
        "maxValue": 54
      },
      {
        "@type": "QuantitativeValue",
        "valueReference": "https://schema.org/BodyMeasurementHeight",
        "unitCode": "FOT",
        "minValue": 6,
        "maxValue": 6.3
      }
    ]
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.example.com/jacket?s=l&c=g",
    "priceCurrency": "USD",
    "price": 239.99,
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock"
  }
}

</script>
Structured representation of the JSON-LD example.