SizeSpecification
A Schema.org Enumeration Type
This term is in the "new" area - implementation feedback and adoption from applications and websites can help improve our definitions.
- Canonical URL: https://schema.org/SizeSpecification
- Check for open issues.
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).
Property | Expected Type | Description |
---|---|---|
Properties from SizeSpecification | ||
hasMeasurement |
QuantitativeValue | A measurement of an item, For example, the inseam of pants, the wheel size of a bicycle, the gauge of a screw, or the carbon footprint measured for certification by an authority. 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 characteristic of the entity, 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 |
Text or 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. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide. |
alternateName |
Text | An alias for the item. |
description |
Text or TextObject |
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
Property | On Types | Description |
---|---|---|
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 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": "Brand", "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/WearableMeasurementChestOrBust", "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.