QuantitativeValue

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

Thing > Intangible > StructuredValue > QuantitativeValue

A point value or interval for product characteristics and other purposes.

Usage: Between 1000 and 10,000 domains
PropertyExpected TypeDescription
Properties from QuantitativeValue
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. 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.

maxValue Number The upper value of some characteristic or property.
minValue Number The lower value of some characteristic or property.
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 QuantitativeValue may appear as values for the following properties

PropertyOn TypesDescription
advanceBookingRequirement Demand  or
Offer 
The amount of time that is required between accepting the offer and the actual usage of the resource or service.
annualPercentageRate FinancialProduct The annual rate that is charged for borrowing (or made by investing), expressed as a single percentage number that represents the actual yearly cost of funds over the term of a loan. This includes any fees or additional costs associated with the transaction.
cargoVolume Vehicle The available volume for cargo or luggage. For automobiles, this is usually the trunk volume.

Typical unit code(s): LTR for liters, FTQ for cubic foot/feet

Note: You can use minValue and maxValue to indicate ranges.

deliveryLeadTime Demand  or
Offer 
The typical delay between the receipt of the order and the goods either leaving the warehouse or being prepared for pickup, in case the delivery method is on site pickup.
depth Product  or
VisualArtwork 
The depth of the item.
durationOfWarranty WarrantyPromise The duration of the warranty promise. Common unitCode values are ANN for year, MON for months, or DAY for days.
eligibleDuration Demand  or
Offer 
The duration for which the given offer is valid.
eligibleQuantity Demand  or
Offer  or
PriceSpecification 
The interval and unit of measurement of ordering quantities for which the offer or price specification is valid. This allows e.g. specifying that a certain freight charge is valid only for a certain quantity.
floorSize Accommodation The size of the accommodation, e.g. in square meter or squarefoot. Typical unit code(s): MTK for square meter, FTK for square foot, or YDK for square yard
fuelConsumption Vehicle 

The amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km).

  • Note 1: There are unfortunately no standard unit codes for liters per 100 km. Use unitText to indicate the unit of measurement, e.g. L/100 km.
  • Note 2: There are two ways of indicating the fuel consumption, fuelConsumption (e.g. 8 liters per 100 km) and fuelEfficiency (e.g. 30 miles per gallon). They are reciprocal.
  • Note 3: Often, the absolute value is useful only when related to driving speed ("at 80 km/h") or usage pattern ("city traffic"). You can use valueReference to link the value for the fuel consumption to another value.
fuelEfficiency Vehicle 

The distance traveled per unit of fuel used; most commonly miles per gallon (mpg) or kilometers per liter (km/L).

  • Note 1: There are unfortunately no standard unit codes for miles per gallon or kilometers per liter. Use unitText to indicate the unit of measurement, e.g. mpg or km/L.
  • Note 2: There are two ways of indicating the fuel consumption, fuelConsumption (e.g. 8 liters per 100 km) and fuelEfficiency (e.g. 30 miles per gallon). They are reciprocal.
  • Note 3: Often, the absolute value is useful only when related to driving speed ("at 80 km/h") or usage pattern ("city traffic"). You can use valueReference to link the value for the fuel economy to another value.
height MediaObject  or
Person  or
Product  or
VisualArtwork 
The height of the item.
interestRate FinancialProduct The interest rate, charged or paid, applicable to the financial product. Note: This is different from the calculated annualPercentageRate.
inventoryLevel Demand  or
Offer  or
SomeProducts 
The current approximate inventory level for the item or items.
loanTerm LoanOrCredit The duration of the loan or credit agreement.
mileageFromOdometer Vehicle The total distance travelled by the particular vehicle since its initial production, as read from its odometer.

Typical unit code(s): KMT for kilometers, SMI for statute miles

numAdults LodgingReservation The number of adults staying in the unit.
numChildren LodgingReservation The number of children staying in the unit.
numberOfAxles Vehicle The number of axles.

Typical unit code(s): C62

numberOfDoors Vehicle The number of doors.

Typical unit code(s): C62

numberOfEmployees BusinessAudience  or
Organization 
The number of employees in an organization e.g. business.
numberOfForwardGears Vehicle The total number of forward gears available for the transmission system of the vehicle.

Typical unit code(s): C62

numberOfPlayers Game  or
VideoGameSeries 
Indicate how many people can play this game (minimum, maximum, or range).
numberOfPreviousOwners Vehicle The number of owners of the vehicle, including the current one.

Typical unit code(s): C62

numberOfRooms Accommodation  or
Apartment  or
House  or
SingleFamilyResidence  or
Suite 
The number of rooms (excluding bathrooms and closets) of the acccommodation or lodging business. Typical unit code(s): ROM for room or C62 for no unit. The type of room can be put in the unitText property of the QuantitativeValue.
occupancy Apartment  or
HotelRoom  or
SingleFamilyResidence  or
Suite 
The allowed total occupancy for the accommodation in persons (including infants etc). For individual accommodations, this is not necessarily the legal maximum but defines the permitted usage as per the contractual agreement (e.g. a double room used by a single person). Typical unit code(s): C62 for person
partySize FoodEstablishmentReservation  or
TaxiReservation 
Number of people the reservation should accommodate.
referenceQuantity UnitPriceSpecification The reference quantity for which a certain price applies, e.g. 1 EUR per 4 kWh of electricity. This property is a replacement for unitOfMeasurement for the advanced cases where the price does not relate to a standard unit.
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.
vehicleSeatingCapacity Vehicle The number of passengers that can be seated in the vehicle, both in terms of the physical space available, and in terms of limitations set by law.

Typical unit code(s): C62 for persons.

weight Person  or
Product 
The weight of the product or person.
width MediaObject  or
Product  or
VisualArtwork 
The width of the item.
yearlyRevenue BusinessAudience The size of the business in annual revenue.
yearsInOperation BusinessAudience The age of the business.

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

Schema Version 3.2