PropertyValue

Canonical URL: http://schema.org/PropertyValue

Thing > Intangible > StructuredValue > PropertyValue

A property-value pair, e.g. representing a feature of a product or place. Use the 'name' property for the name of the property. If there is an additional human-readable version of the value, put that into the 'description' property.

Always use specific schema.org properties when a) they exist and b) you can populate them. Using PropertyValue as a substitute will typically not trigger the same effect as using the original, specific property.

PropertyExpected TypeDescription
Properties from PropertyValue
maxValue Number The upper value of some characteristic or property.
minValue Number The lower value of some characteristic or property.
propertyID Text  or
URL 		A commonly used identifier for the characteristic represented by the property, e.g. a manufacturer or a standard code for a property. propertyID can be (1) a prefixed string, mainly meant to be used with standards for product properties; (2) a site-specific, non-prefixed string (e.g. the primary key of the property or the vendor-specific id of the property), or (3) a URL indicating the type of the property, either pointing to an external vocabulary, or a Web resource that describes the property (e.g. a glossary entry). Standards bodies should promote a standard prefix for the identifiers of properties from their standards.
unitCode Text  or
URL 		The unit of measurement given using the UN/CEFACT Common Code (3 characters) or a URL. Other codes than the UN/CEFACT Common Code may be used with a prefix followed by a colon.
unitText Text A string or text indicating the unit of measurement. Useful if you cannot provide a standard unit code for unitCode.
value Boolean  or
Number  or
StructuredValue  or
Text 

The value of the quantitative value or property value node.

valueReference Enumeration  or
PropertyValue  or
QualitativeValue  or
QuantitativeValue  or
StructuredValue 		A pointer to a secondary value that provides additional information on the original value, e.g. a reference temperature.
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.
url URL URL of the item.


Instances of PropertyValue may appear as values for the following properties

PropertyOn TypesDescription
additionalProperty Place  or
Product  or
QualitativeValue  or
QuantitativeValue 		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. http://schema.org/width, http://schema.org/color, http://schema.org/gtin13, ...) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism.

exifData ImageObject exif data for this object.
identifier Thing 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.
valueReference PropertyValue  or
QualitativeValue  or
QuantitativeValue 		A pointer to a secondary value that provides additional information on the original value, e.g. a reference temperature.

Available properties in extensions


More specific Types

Acknowledgement

This class is derived from the GoodRelations Vocabulary for E-Commerce, created by Martin Hepp. GoodRelations is a data model for sharing e-commerce data on the Web that can be expressed in a variety of syntaxes, including RDFa and HTML5 Microdata. More information about GoodRelations can be found at http://purl.org/goodrelations/.



Examples

Example 1
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Boolean Value -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>USB interface</span>: Yes
  </div>
</div>

<!-- Product: Boolean Value -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">USB interface</span>:
      <meta itemprop="value" content="True">Yes
  </div>
</div>

No RDFa

No JSON-LD
Example 2
Without Markup Microdata RDFa JSON-LD 
<h2>Beach in Mexico</h2>
<img src="mexico-beach.jpg" alt="" />
By Jane Doe
Photographed in Puerto Vallarta, Mexico
Date uploaded: Jan 25, 2008
I took this picture while on vacation last year.
<!-- We assume the following EXIF meta-data is available, but currently not shown:
Exposure Time:    1/659 sec.
FNumber:          f/4.0
MaxApertureValue: 2.00
Metering Mode:    Pattern
Flash:            Flash did not fire.
-->

<div itemscope itemtype="http://schema.org/ImageObject">
  <h2 itemprop="name">Beach in Mexico</h2>
  <img src="mexico-beach.jpg" alt="" itemprop="contentUrl" />
  By <span itemprop="author">Jane Doe</span>
  Photographed in
    <span itemprop="contentLocation">Puerto Vallarta, Mexico</span>
  Date uploaded:
    <meta itemprop="datePublished" content="2008-01-25">Jan 25, 2008
  <span itemprop="description">I took this picture while on vacation last year.</span>
<!-- Note: We do not split value strings in unit and value information, since this the raw EXIF data does not provide this granularity. If you are able to separate the unit, you can use the unitText property -->
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="Exposure Time">
      <meta itemprop="value" content="1/659 sec.">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="FNumber">
      <meta itemprop="value" content="f/4.0">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="MaxApertureValue">
      <meta itemprop="value" content="2.00">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="Metering Mode">
      <meta itemprop="value" content="Pattern">
  </div>
  <div itemprop="exifData" itemscope itemtype="http://schema.org/PropertyValue">
      <meta itemprop="name" content="Flash">
      <meta itemprop="value" content="Flash did not fire.">
  </div>
</div>

<div vocab="http://schema.org/" typeof="ImageObject">
  <h2 property="name">Beach in Mexico</h2>
  <img src="mexico-beach.jpg" alt="" property="contentUrl" />
  By <span property="author">Jane Doe</span>
  Photographed in
    <span property="contentLocation">Puerto Vallarta, Mexico</span>
  Date uploaded:
    <meta property="datePublished" content="2008-01-25">Jan 25, 2008
  <span property="description">I took this picture while on vacation last year.</span>
<!-- Note: We do not split value strings in unit and value information, since this the raw EXIF data does not provide this granularity. If you are able to separate the unit, you can use the unitText property -->
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="Exposure Time">
      <meta property="value" content="1/659 sec.">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="FNumber">
      <meta property="value" content="f/4.0">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="MaxApertureValue">
      <meta property="value" content="2.00">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="Metering Mode">
      <meta property="value" content="Pattern">
  </div>
  <div property="exifData" typeOf="PropertyValue">
      <meta property="name" content="Flash">
      <meta property="value" content="Flash did not fire.">
  </div>
</div>

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "ImageObject",
  "author": "Jane Doe",
  "contentLocation": "Puerto Vallarta, Mexico",
  "contentUrl": "mexico-beach.jpg",
  "datePublished": "2008-01-25",
  "description": "I took this picture while on vacation last year.",
  "name": "Beach in Mexico",
  "exifData": [
    {
      "@type": "PropertyValue",
      "name": "Exposure Time",
      "value": "1/659 sec."
    },
    {
     "@type": "PropertyValue",
      "name": "FNumber",
      "value": "f/4.0"
    },
    {
      "@type": "PropertyValue",
      "name": "MaxApertureValue",
      "value": "2.00"
    },
    {
      "@type": "PropertyValue",
      "name": "Metering Mode",
      "value": "Pattern"
    },
    {
      "@type": "PropertyValue",
      "name": "Flash",
      "value": "Flash did not fire."
    }
  ]
}
</script>
Example 3
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Grouping and Hierarchical Order of Properties -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <strong>Focus/Autofocus</strong>
      <div>
        <span>Picture Control</span>
        <span>Landscape</span>
        <span>Monochrome</span>
        <span>Portrait</span>
      </div>
      <div>
        <span>Single-point AF Mode</span>: Yes
      </div>
  </div>
</div>

<!-- Product: Grouping and Hierarchical Order of Properties -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <strong itemprop="name">Focus/Autofocus</strong>
      <div itemprop="value" itemscope itemtype="http://schema.org/PropertyValue">
        <span itemprop="name">Picture Control</span>
        <span itemprop="value">Landscape</span>
        <span itemprop="value">Monochrome</span>
        <span itemprop="value">Portrait</span>
      </div>
      <div itemprop="value" itemscope itemtype="http://schema.org/PropertyValue">
        <span itemprop="name">Single-point AF Mode</span>:
        <meta itemprop="value" content="True">Yes
      </div>
  </div>
</div>

No RDFa

No JSON-LD
Example 4
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Multiple Intervals -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Operating voltage</span>:
      <span>9-12</span> or
      <span>100-250</span>
      volts
  </div>
</div>

<!-- Product: Multiple Intervals -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Operating voltage</span>:
      <span itemprop="value">9-12</span> or
      <span itemprop="value">100-250</span>
      <meta itemprop="unitCode" content="VLT">volts
  </div>
</div>

No RDFa

No JSON-LD
Example 5
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Open Interval, with unit as UN/CEFACT Common Code to be added to the template -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Wifi range</span>: up to
      <span>30</span>
      ft.
  </div>
</div>

<!-- Product: Open Interval, with unit as UN/CEFACT Common Code -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Wifi range</span>: up to
      <span itemprop="maxValue">30</span>
<!-- Note: The UN/CEFACT Common Code for foot is FOT -->
      <meta itemprop="unitCode" content="FOT">ft.
  </div>
</div>

No RDFa

No JSON-LD
Example 6
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Point Value, with unit as symbol -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Approx. Weight</span>
      <span>450</span>
      <span>g</span>
  </div>
</div>

<!-- Product: Point Value, with unit as symbol -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Approx. Weight</span>
      <span itemprop="value">450</span>
      <span itemprop="unitText">g</span>
  </div>
</div>

No RDFa

No JSON-lD
Example 7
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Point Value, with unit as symbol -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Approx. Weight</span>
      <span>450</span>
      <span>g</span>
  </div>
</div>

<!-- Product: Point Value, with unit as symbol -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Approx. Weight</span>
      <span itemprop="value">450</span>
      <span itemprop="unitText">g</span>
  </div>
</div>

No RDFa

No JSON-lD
Example 8
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Point Value, with unit as UN/CEFACT Common Code to be added to the template -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Approx. Weight</span>
      <span>450</span>g
  </div>
</div>

<!-- Product: Point Value, with unit as UN/CEFACT Common Code -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Approx. Weight</span>
      <span itemprop="value">450</span>
      <meta itemprop="unitCode" content="GRM">g
  </div>
</div>

No RDFa

No JSON-LD
Example 9
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Property ID for clarifying the meaning of a property: URI from external vocabulary -->
<!-- (see microdata example for comparison) -->
<div>
  <img src="station_waggon123.jpg" alt="" />
  <span>Station Waggon 123</span>
  <div>
      <span>Luggage Capacity (seats folded)</span>:
      <span>500</span>
      liter
  </div>
</div>

<!-- Product: Property ID for clarifying the meaning of a property: URI from external vocabulary -->
<div itemscope itemtype="http://schema.org/Car">
  <img itemprop="image" src="station_waggon123.jpg" alt="" />
  <span itemprop="name">Station Waggon 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Luggage Capacity (seats folded)</span>:
      <span itemprop="value">500</span>
      <meta itemprop="unitCode" content="LTR">liter
      <link itemprop="propertyID" href="http://purl.org/vvo/ns#luggageCapacitySeatsFolded" />
  </div>
</div>

No RDFa

No JSON-LD
Example 10
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Property ID for clarifying the meaning of a property: Code from eCl@ss Standard -->
<!-- The Property code 02-AAM226 is for "USB interface present" in eCl@ss 8.1
(see microdata example for comparison) -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>USB Interface</span>:Yes
  </div>
</div>

<!-- Product: Property ID for clarifying the meaning of a property: Code from eCl@ss Standard -->
<!-- The Property code 02-AAM226 is for "USB interface present" in eCl@ss 8.1 -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">USB Interface</span>:
      <meta itemprop="value" content="True">Yes
      <meta itemprop="propertyID" content="eclass81:02-AAM226">
  </div>
</div>

No RDFa

No JSON-LD
Example 11
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Qualitative Value -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Interface</span>: <span>USB</span>
  </div>
</div>

<!-- Product: Qualitative Value -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Interface</span>:
      <span itemprop="value">USB</span>
  </div>
</div>

No RDFa

No JSON-LD
Example 12
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Qualitative Value (multiple) -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Interfaces</span>:
      <span>USB</span>,
      <span>Ethernet</span>
  </div>
</div>

<!-- Product: Qualitative Value (multiple) -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Interfaces</span>:
      <span itemprop="value">USB</span>,
      <span itemprop="value">Ethernet</span>
  </div>
</div>

No RDFa

No JSON-LD
Example 13
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Range, with unit as UN/CEFACT Common Code to be added to the template -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Operating Voltage</span>
      <span>100</span>-
      <span>250</span>
      volts
  </div>
</div>

<!-- Product: Range, with unit as UN/CEFACT Common Code -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Operating Voltage</span>
      <span itemprop="minValue">100</span>-
      <span itemprop="maxValue">250</span>
      <meta itemprop="unitCode" content="VLT">volts
  </div>
</div>

No RDFa

No JSON-LD
Example 14
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Range and Enumerated Values -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>ISO Sensitivity</span>:
      <span>100-6400</span>/
      <span>12,800</span> (Hi-1)
      <span>ISO</span>
  </div>
</div>

<!-- Product: Range and Enumerated Values -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">ISO Sensitivity</span>:
      <span itemprop="value">100-6400</span>/
      <span itemprop="value">12,800</span> (Hi-1)
      <span itemprop="unitText">ISO</span>
  </div>
</div>

No RDFa

No JSON-LD
Example 15
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Ratios -->
<div>
  <img src="station_waggon123.jpg" alt="" />
  <span>Station Waggon 123</span>
  <div>
      <span>Fuel consumption</span>:
      <span>5</span>
      <meta>liter</span> /
      <div>
        <span>100</span>
        <span>km</span>
      </div>
  </div>
</div>

<!-- Product: Ratios -->
<div itemscope itemtype="http://schema.org/Car">
  <img itemprop="image" src="station_waggon123.jpg" alt="" />
  <span itemprop="name">Station Waggon 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Fuel consumption</span>:
      <span itemprop="value">5</span>
      <meta itemprop="unitCode" content="LTR">liter /
      <div itemprop="valueReference" itemscope itemtype="http://schema.org/PropertyValue">
        <span itemprop="value">100</span>
        <span itemprop="unitText">km</span>
      </div>
  </div>
</div>

No RDFa

No JSON-LD
Example 16
Without Markup Microdata RDFa JSON-LD 
<!-- Product: Value References -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Operating Voltage</span>
      <span>100</span>-
      <span>250</span>
      volts
      at
      <div>
         <span>50</span>
         <span>Hz</span>
      </div>
  </div>
</div>

<!-- Product: Value References -->
<div itemscope itemtype="http://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="http://schema.org/PropertyValue">
      <span itemprop="name">Operating Voltage</span>
      <span itemprop="minValue">100</span>-
      <span itemprop="maxValue">250</span>
      <meta itemprop="unitCode" content="VLT">volts
      at
      <div itemprop="valueReference" itemscope itemtype="http://schema.org/PropertyValue">
         <span itemprop="value">50</span>
         <span itemprop="unitText">Hz</span>
      </div>
  </div>
</div>

No RDFa

No JSON-LD

Schema Version 3.2