QuantitativeValue

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

Subclass of: StructuredValue

Properties from QuantitativeValue

Property Expected Type Description
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.
maxValue Number The upper value of some characteristic or property.
minValue Number The lower value of some characteristic or property.
unitCode Text, 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 Text, Number, Boolean, StructuredValue The value of a QuantitativeValue (including Observation) or property value node.

* For QuantitativeValue and MonetaryAmount, the recommended type for values is 'Number'.
* For PropertyValue, it can be 'Text', 'Number', 'Boolean', or 'StructuredValue'.
* Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols.
* Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.
valueReference QualitativeValue, Text, DefinedTerm, MeasurementTypeEnumeration, Enumeration, PropertyValue, StructuredValue, QuantitativeValue A secondary value that provides additional information on the original value, e.g. a reference temperature or a type of measurement.

Properties from Thing

Property Expected Type Description
additionalType Text, 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 TextObject, 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, URL, Text 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, URL An image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPage URL, CreativeWork Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
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, Event A CreativeWork or Event about this Thing.
url URL URL of the item.

Instances of QuantitativeValue may appear as a value for the following properties

Property On Types Description
accelerationTime Vehicle The time needed to accelerate the vehicle from a given start velocity to a given target velocity.

Typical unit code(s): SEC for seconds

* Note: There are unfortunately no standard unit codes for seconds/0..100 km/h or seconds/0..60 mph. Simply use "SEC" for seconds and indicate the velocities in the name of the QuantitativeValue, or use valueReference with a QuantitativeValue of 0..60 mph or 0..100 km/h to specify the reference speeds.
activityDuration ExercisePlan Length of time to engage in the activity.
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.
billingDuration UnitPriceSpecification Specifies for how long this price (or price component) will be billed. Can be used, for example, to model the contractual duration of a subscription or payment plan. Type can be either a Duration or a Number (in which case the unit of measurement, for example month, is specified by the unitCode property).
deliveryLeadTime Demand, 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 OfferShippingDetails, ShippingConditions, VisualArtwork, Product The depth of the item.
engineDisplacement EngineSpecification The volume swept by all of the pistons inside the cylinders of an internal combustion engine in a single movement.

Typical unit code(s): CMQ for cubic centimeter, LTR for liters, INQ for cubic inches
* Note 1: You can link to information about how the given value has been determined using the valueReference property.
* Note 2: You can use minValue and maxValue to indicate ranges.
fuelCapacity Vehicle The capacity of the fuel tank or in the case of electric cars, the battery. If there are multiple components for storage, this should indicate the total of all storage of the same type.

Typical unit code(s): LTR for liters, GLL of US gallons, GLI for UK / imperial gallons, AMH for ampere-hours (for electrical vehicles).
handlingTime ShippingService, ShippingDeliveryTime 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. In the context of ShippingDeliveryTime, Typical properties: minValue, maxValue, unitCode (d for DAY). This is by common convention assumed to mean business days (if a unitCode is used, coded as "d"), i.e. only counting days when the business normally operates. In the context of ShippingService, use the ServicePeriod format, that contains the same information in a structured form, with cut-off time, business days and duration.
hasMeasurement Certification, Offer, SizeSpecification, Product 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.
incentiveAmount FinancialIncentive Describes the amount that can be redeemed from this incentive.

QuantitativeValue: Use this for incentives based on price (either raw amount or percentage-based). For a raw amount example, "You can claim $2,500 - $7,500 from the total cost of installation" would be represented as the following:

@type

QuantitivateValue can also be used for percentage amounts. In such cases, value is used to represent the incentive’s percentage, while maxValue represents a limit (if one exists) to that incentive. The unitCode should be 'P1' and the unitText should be '%', while valueReference should be used for holding the currency type. For example, "You can claim up to 30% of the total cost of installation, up to a maximum of $7,500" would be:

@type

UnitPriceSpecification: Use this for incentives that are based on amounts rather than price. For example, a net metering rebate that pays $10/kWh, up to $1,000:

@type

LoanOrCredit: Use for incentives that are loan based. For example, a loan of $4,000 - $50,000 with a repayment term of 10 years, interest free would look like:

@type, "amount":[ @type, ], "amount":[ @type, @type ], }} In summary: .
intensity ExercisePlan Quantitative measure gauging the degree of force involved in the exercise, for example, heartbeats per minute. May include the velocity of the movement.
loanTerm LoanOrCredit The duration of the loan or credit agreement.
monoisotopicMolecularWeight MolecularEntity The monoisotopic mass is the sum of the masses of the atoms in a molecule using the unbound, ground-state, rest mass of the principal (most abundant) isotope for each element instead of the isotopic average mass. Please include the units in the form '<Number> <unit>', for example '770.230488 g/mol' or as '<QuantitativeValue>.
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.
numberOfBedrooms FloorPlan, ApartmentComplex, Accommodation The total integer number of bedrooms in a some Accommodation, ApartmentComplex or FloorPlan.
numberOfPreviousOwners Vehicle The number of owners of the vehicle, including the current one.

Typical unit code(s): C62.
numberOfRooms LodgingBusiness, Suite, House, Accommodation, FloorPlan, SingleFamilyResidence, Apartment The number of rooms (excluding bathrooms and closets) of the accommodation 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.
orderQuantity OrderItem The number of the item ordered. If the property is not set, assume the quantity is one.
partySize FoodEstablishmentReservation, TaxiReservation Number of people the reservation should accommodate.
payload Vehicle The permitted weight of passengers and cargo, EXCLUDING the weight of the empty vehicle.

Typical unit code(s): KGM for kilogram, LBR for pound

* Note 1: Many databases specify the permitted TOTAL weight instead, which is the sum of weight and payload
* Note 2: You can indicate additional information in the name of the QuantitativeValue node.
* Note 3: You may also link to a QualitativeValue node that provides additional information using valueReference.
* Note 4: Note that you can use minValue and maxValue to indicate ranges.
repetitions ExercisePlan Number of times one should repeat the activity.
roofLoad BusOrCoach, Car The permitted total weight of cargo and installations (e.g. a roof rack) on top of the vehicle.

Typical unit code(s): KGM for kilogram, LBR for pound

* Note 1: You can indicate additional information in the name of the QuantitativeValue node.
* Note 2: You may also link to a QualitativeValue node that provides additional information using valueReference
* Note 3: Note that you can use minValue and maxValue to indicate ranges.
speed Vehicle The speed range of the vehicle. If the vehicle is powered by an engine, the upper limit of the speed range (indicated by maxValue) should be the maximum speed achievable under regular conditions.

Typical unit code(s): KMH for km/h, HM for mile per hour (0.447 04 m/s), KNT for knot

*Note 1: Use minValue and maxValue to indicate the range. Typically, the minimal value is zero.
* Note 2: There are many different ways of measuring the speed range. You can link to information about how the given value has been determined using the valueReference property.
suggestedMeasurement SizeSpecification, PeopleAudience 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.
tongueWeight Vehicle The permitted vertical load (TWR) of a trailer attached to the vehicle. Also referred to as Tongue Load Rating (TLR) or Vertical Load Rating (VLR).

Typical unit code(s): KGM for kilogram, LBR for pound

* Note 1: You can indicate additional information in the name of the QuantitativeValue node.
* Note 2: You may also link to a QualitativeValue node that provides additional information using valueReference.
* Note 3: Note that you can use minValue and maxValue to indicate ranges.
torque EngineSpecification The torque (turning force) of the vehicle's engine.

Typical unit code(s): NU for newton metre (N m), F17 for pound-force per foot, or F48 for pound-force per inch

* Note 1: You can link to information about how the given value has been determined (e.g. reference RPM) using the valueReference property.
* Note 2: You can use minValue and maxValue to indicate ranges.
trailerWeight Vehicle The permitted weight of a trailer attached to the vehicle.

Typical unit code(s): KGM for kilogram, LBR for pound
* Note 1: You can indicate additional information in the name of the QuantitativeValue node.
* Note 2: You may also link to a QualitativeValue node that provides additional information using valueReference.
* Note 3: Note that you can use minValue and maxValue to indicate ranges.
valueReference PropertyValue, QuantitativeValue, QualitativeValue A secondary value that provides additional information on the original value, e.g. a reference temperature or a type of measurement.
weight ShippingConditions, VisualArtwork, Person, OfferShippingDetails, Product The weight of the product or person.
weightTotal Vehicle The permitted total weight of the loaded vehicle, including passengers and cargo and the weight of the empty vehicle.

Typical unit code(s): KGM for kilogram, LBR for pound

* Note 1: You can indicate additional information in the name of the QuantitativeValue node.
* Note 2: You may also link to a QualitativeValue node that provides additional information using valueReference.
* Note 3: Note that you can use minValue and maxValue to indicate ranges.
wheelbase Vehicle The distance between the centers of the front and rear wheels.

Typical unit code(s): CMT for centimeters, MTR for meters, INH for inches, FOT for foot/feet.
width VisualArtwork, Product, OfferShippingDetails, MediaObject, ShippingConditions The width of the item.
workload ExercisePlan Quantitative measure of the physiologic output of the exercise; also referred to as energy expenditure.
yearlyRevenue BusinessAudience The size of the business in annual revenue.
yearsInOperation BusinessAudience The age of the business.
yield HowTo The quantity that results by performing instructions. For example, a paper airplane, 10 personalized candles.