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.

Example eg-0404

Without Markup (source lint)

<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.
-->

RDFa (source lint)

<div vocab="https://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>

microdata (source lint)

<div itemscope itemtype="https://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="https://schema.org/PropertyValue">
      <meta itemprop="name" content="Exposure Time">
      <meta itemprop="value" content="1/659 sec.">
  </div>
  <div itemprop="exifData" itemscope itemtype="https://schema.org/PropertyValue">
      <meta itemprop="name" content="FNumber">
      <meta itemprop="value" content="f/4.0">
  </div>
  <div itemprop="exifData" itemscope itemtype="https://schema.org/PropertyValue">
      <meta itemprop="name" content="MaxApertureValue">
      <meta itemprop="value" content="2.00">
  </div>
  <div itemprop="exifData" itemscope itemtype="https://schema.org/PropertyValue">
      <meta itemprop="name" content="Metering Mode">
      <meta itemprop="value" content="Pattern">
  </div>
  <div itemprop="exifData" itemscope itemtype="https://schema.org/PropertyValue">
      <meta itemprop="name" content="Flash">
      <meta itemprop="value" content="Flash did not fire.">
  </div>
</div>

JSON-LD (source lint)

<script type="application/ld+json">
{
  "@context": "https://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>

structured

rdf:type schema:ImageObject
schema:author Jane Doe
schema:contentLocation Puerto Vallarta, Mexico
schema:datePublished 2008-01-25
schema:description I took this picture while on vacation last year.
schema:exifData
  • rdf:type schema:PropertyValue
    schema:name Metering Mode
    schema:value Pattern
  • rdf:type schema:PropertyValue
    schema:name FNumber
    schema:value f/4.0
  • rdf:type schema:PropertyValue
    schema:name Exposure Time
    schema:value 1/659 sec.
  • rdf:type schema:PropertyValue
    schema:name MaxApertureValue
    schema:value 2.00
  • rdf:type schema:PropertyValue
    schema:name Flash
    schema:value Flash did not fire.
schema:name Beach in Mexico

Example eg-0405

Without Markup (source lint)

<!-- Product: Point Value, with unit as text -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Approx. Weight</span>
      <span>450</span>
      <span>gram</span>
  </div>
</div>

RDFa (source lint)

No RDFa

microdata (source lint)

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

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0406

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

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

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0407

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Range, with unit as UN/CEFACT Common Code -->
<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0408

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Open Interval, with unit as UN/CEFACT Common Code -->
<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0409

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Multiple Intervals -->
<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0410

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Range and Enumerated Values -->
<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0411

Without Markup (source lint)

<!-- Product: Boolean Value -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>USB interface</span>: Yes
  </div>
</div>

RDFa (source lint)

No RDFa

microdata (source lint)

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

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0412

Without Markup (source lint)

<!-- Product: Qualitative Value -->
<div>
  <img src="camera123.jpg" alt="" />
  <span>Digital Camera 123</span>
  <div>
      <span>Interface</span>: <span>USB</span>
  </div>
</div>

RDFa (source lint)

No RDFa

microdata (source lint)

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

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0413

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

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

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0414

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Property ID for clarifying the meaning of a property: URI from external vocabulary -->
<div itemscope itemtype="https://schema.org/Car">
  <img itemprop="image" src="station_waggon123.jpg" alt="" />
  <span itemprop="name">Station Waggon 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0415

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- 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="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
      <span itemprop="name">USB Interface</span>:
      <meta itemprop="value" content="True">Yes
      <meta itemprop="propertyID" content="eclass81:02-AAM226">
  </div>
</div>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0416

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Value References -->
<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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="https://schema.org/PropertyValue">
         <span itemprop="value">50</span>
         <span itemprop="unitText">Hz</span>
      </div>
  </div>
</div>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0417

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Ratios -->
<div itemscope itemtype="https://schema.org/Car">
  <img itemprop="image" src="station_waggon123.jpg" alt="" />
  <span itemprop="name">Station Waggon 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://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="https://schema.org/PropertyValue">
        <span itemprop="value">100</span>
        <span itemprop="unitText">km</span>
      </div>
  </div>
</div>

JSON-LD (source lint)

No JSON-LD

structured

Example eg-0418

Without Markup (source lint)

<!-- 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>

RDFa (source lint)

No RDFa

microdata (source lint)

<!-- Product: Grouping and Hierarchical Order of Properties -->
<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="camera123.jpg" alt="" />
  <span itemprop="name">Digital Camera 123</span>
  <div itemprop="additionalProperty" itemscope itemtype="https://schema.org/PropertyValue">
      <strong itemprop="name">Focus/Autofocus</strong>
      <div itemprop="value" itemscope itemtype="https://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="https://schema.org/PropertyValue">
        <span itemprop="name">Single-point AF Mode</span>:
        <meta itemprop="value" content="True">Yes
      </div>
  </div>
</div>

JSON-LD (source lint)

No JSON-LD

structured