Add Schema Checker to your device

Use your browser menu to install this website as an app or add it to your home screen.

Schema.org type reference

QuantitativeValue — Schema.org Type, Hierarchy & Properties

Learn about Schema.org QuantitativeValue: parent types, child types, property value relationships and official references. Independent local educational guide.

Source: Schema.org v30.1 offline vocabulary. Official QuantitativeValue definition.

What is QuantitativeValue?

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

Example JSON-LD skeleton

This minimal example only identifies a Schema.org type. It is not a complete entity, a Google rich-result test, or a claim about a real business.

{
  "@context": "https://schema.org",
  "@type": "QuantitativeValue"
}

Full parent hierarchy

Each chain starts at a root type. Multiple paths are shown when Schema.org defines more than one parent. For very complex types, up to 256 paths are displayed; consult the official definition for the full graph.

  1. Thing → Intangible → StructuredValue → QuantitativeValue

Direct parents: StructuredValue

Child types (1)

Properties that accept QuantitativeValue values (79)

PropertyOn typesDescription
accelerationTimeVehicleThe time needed to accelerate the vehicle from a given start velocity to a given target velocity.\n\nTypical unit code(s): SEC for seconds\n\n* 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.
activityDurationExercisePlanLength of time to engage in the activity.
activityFrequencyExercisePlanHow often one should engage in the activity.
advanceBookingRequirementDemand or OfferThe amount of time that is required between accepting the offer and the actual usage of the resource or service.
annualPercentageRateFinancialProductThe 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.
billingDurationUnitPriceSpecificationSpecifies 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).
broadcastFrequencyValueBroadcastFrequencySpecificationThe frequency in MHz for a particular broadcast.
cargoVolumeVehicleThe available volume for cargo or luggage. For automobiles, this is usually the trunk volume.\n\nTypical unit code(s): LTR for liters, FTQ for cubic foot/feet\n\nNote: You can use [[minValue]] and [[maxValue]] to indicate ranges.
deliveryLeadTimeDemand or OfferThe 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.
depthOfferShippingDetails or Product or ShippingConditions or VisualArtworkThe depth of the item.
durationAudiobook or Episode or Event or MediaObject or Movie or MusicRecording or MusicRelease or QuantitativeValueDistribution or Schedule or ServicePeriodThe duration of the item (movie, audio recording, event, etc.) in [ISO 8601 duration format](http://en.wikipedia.org/wiki/ISO_8601).
durationOfWarrantyWarrantyPromiseThe duration of the warranty promise. Common unitCode values are ANN for year, MON for months, or DAY for days.
eligibleDurationDemand or OfferThe duration for which the given offer is valid.
eligibleQuantityDemand or Offer or PriceSpecificationThe 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.
engineDisplacementEngineSpecificationThe volume swept by all of the pistons inside the cylinders of an internal combustion engine in a single movement. \n\nTypical unit code(s): CMQ for cubic centimeter, LTR for liters, INQ for cubic inches\n* Note 1: You can link to information about how the given value has been determined using the [[valueReference]] property.\n* Note 2: You can use [[minValue]] and [[maxValue]] to indicate ranges.
enginePowerEngineSpecificationThe power of the vehicle's engine. Typical unit code(s): KWT for kilowatt, BHP for brake horsepower, N12 for metric horsepower (PS, with 1 PS = 735,49875 W)\n\n* Note 1: There are many different ways of measuring an engine's power. For an overview, see [http://en.wikipedia.org/wiki/Horsepower#Engine\_power\_test\_codes](http://en.wikipedia.org/wiki/Horsepower#Engine_power_test_codes).\n* Note 2: You can link to information about how the given value has been determined using the [[valueReference]] property.\n* Note 3: You can use [[minValue]] and [[maxValue]] to indicate ranges.
floorSizeAccommodation or FloorPlanThe 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.
fuelCapacityVehicleThe 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.\n\nTypical unit code(s): LTR for liters, GLL of US gallons, GLI for UK / imperial gallons, AMH for ampere-hours (for electrical vehicles).
fuelConsumptionVehicleThe amount of fuel consumed for traveling a particular distance or temporal duration with the given vehicle (e.g. liters per 100 km).\n\n* 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.\n* 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.\n* 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.
fuelEfficiencyVehicleThe distance traveled per unit of fuel used; most commonly miles per gallon (mpg) or kilometers per liter (km/L).\n\n* 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.\n* 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.\n* 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.
handlingTimeShippingDeliveryTime or ShippingServiceThe 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.
hasMeasurementCertification or Offer or Product or SizeSpecificationA 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.
heightMediaObject or OfferShippingDetails or Person or Product or ShippingConditions or VisualArtworkThe height of the item.
incentiveAmountFinancialIncentiveDescribes the amount that can be redeemed from this incentive. <p>[[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:</p> { "@type": "QuantitativeValue", “minValue”: 2500, “maxValue”: 7500, "unitCode": "USD" } <p>[[QuantitativeValue]] 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:</p> { "@type": "QuantitativeValue", "value": 30, "unitCode": "P1", "unitText": "%", “maxValue”: 7500, “valueReference”: “USD” } <p>[[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:</p> { "@type": "UnitPriceSpecification", "price": 10, "priceCurrency": "USD", "referenceQuantity": 1, "unitCode": "DO3", "unitText": "kw/h", "maxPrice": 1000, "description": "$10 / kwh up to $1000" } <p>[[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:</p> { "@type": "LoanOrCredit", "loanTerm": { "@type":"QuantitativeValue", "value":"10", "unitCode": "ANN" }, "amount":[ { "@type": "QuantitativeValue", "Name":"fixed interest rate", "value":"0", }, ], "amount":[ { "@type": "MonetaryAmount", "Name":"min loan amount", "value":"4000", "currency":"CAD" }, { "@type": "MonetaryAmount", "Name":"max loan amount", "value":"50000", "currency":"CAD" } ], } In summary: <ul><li>Use [[QuantitativeValue]] for absolute/percentage-based incentives applied on the price of a good/service.</li> <li>Use [[UnitPriceSpecification]] for incentives based on a per-unit basis (e.g. net metering).</li> <li>Use [[LoanOrCredit]] for loans/credits.</li> </ul>.
intensityExercisePlanQuantitative measure gauging the degree of force involved in the exercise, for example, heartbeats per minute. May include the velocity of the movement.
interestRateFinancialProductThe interest rate, charged or paid, applicable to the financial product. Note: This is different from the calculated annualPercentageRate.
inventoryLevelDemand or Offer or SomeProductsThe current approximate inventory level for the item or items.
itemPopularityOfferA measure of the relative popularity or sales rank of the offer within a marketplace, catalog, or platform (e.g. a platform-specific bestseller ranking or sales rank). This property is intended for platform-level or catalog-wide comparative rankings rather than self-asserted promotional claims.
jobDurationJobPostingThe expected duration of an employment offer as advertised by the employer. Relevant for job postings that have a clearly defined period in mind such as seasonal work, substitutes for maternal leave or any other temporary employment.
leaseLengthAccommodation or Offer or RealEstateListingLength of the lease for some [[Accommodation]], either particular to some [[Offer]] or in some cases intrinsic to the property.
loanTermLoanOrCreditThe duration of the loan or credit agreement.
marginOfErrorObservationA [[marginOfError]] for an [[Observation]].
materialExtentCreativeWorkThe quantity of the materials being described or an expression of the physical space they occupy.
membershipPointsEarnedMemberProgramTier or PriceSpecification or ProgramMembershipThe number of membership points earned by the member. If necessary, the unitText can be used to express the units the points are issued in. (E.g. stars, miles, etc.)
mileageFromOdometerVehicleThe total distance travelled by the particular vehicle since its initial production, as read from its odometer.\n\nTypical unit code(s): KMT for kilometers, SMI for statute miles.
molecularWeightMolecularEntityThis is the molecular weight of the entity being described, not of the parent. Units should be included in the form '&lt;Number&gt; &lt;unit&gt;', for example '12 amu' or as '&lt;QuantitativeValue&gt;.
monoisotopicMolecularWeightMolecularEntityThe 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 '&lt;Number&gt; &lt;unit&gt;', for example '770.230488 g/mol' or as '&lt;QuantitativeValue&gt;.
numAdultsLodgingReservationThe number of adults staying in the unit.
numChildrenLodgingReservationThe number of children staying in the unit.
numItemsShippingConditionsLimits the number of items being shipped for which these conditions apply.
numberOfAccommodationUnitsApartmentComplex or FloorPlanIndicates the total (available plus unavailable) number of accommodation units in an [[ApartmentComplex]], or the number of accommodation units for a specific [[FloorPlan]] (within its specific [[ApartmentComplex]]). See also [[numberOfAvailableAccommodationUnits]].
numberOfAvailableAccommodationUnitsApartmentComplex or FloorPlanIndicates the number of available accommodation units in an [[ApartmentComplex]], or the number of accommodation units for a specific [[FloorPlan]] (within its specific [[ApartmentComplex]]). See also [[numberOfAccommodationUnits]].
numberOfAxlesVehicleThe number of axles.\n\nTypical unit code(s): C62.
numberOfBedroomsAccommodation or ApartmentComplex or FloorPlanThe total integer number of bedrooms in a some [[Accommodation]], [[ApartmentComplex]] or [[FloorPlan]].
numberOfDoorsVehicleThe number of doors.\n\nTypical unit code(s): C62.
numberOfEmployeesBusinessAudience or OrganizationThe number of employees in an organization, e.g. business.
numberOfForwardGearsVehicleThe total number of forward gears available for the transmission system of the vehicle.\n\nTypical unit code(s): C62.
numberOfPlayersGame or VideoGameSeriesIndicate how many people can play this game (minimum, maximum, or range).
numberOfPreviousOwnersVehicleThe number of owners of the vehicle, including the current one.\n\nTypical unit code(s): C62.
numberOfRoomsAccommodation or Apartment or FloorPlan or House or LodgingBusiness or SingleFamilyResidence or SuiteThe 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.
occupancyAccommodation or Apartment or HotelRoom or SingleFamilyResidence or SuiteThe 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.
orderQuantityOrderItemThe number of the item ordered. If the property is not set, assume the quantity is one.
partySizeFoodEstablishmentReservation or TaxiReservationNumber of people the reservation should accommodate.
payloadVehicleThe permitted weight of passengers and cargo, EXCLUDING the weight of the empty vehicle.\n\nTypical unit code(s): KGM for kilogram, LBR for pound\n\n* Note 1: Many databases specify the permitted TOTAL weight instead, which is the sum of [[weight]] and [[payload]]\n* Note 2: You can indicate additional information in the [[name]] of the [[QuantitativeValue]] node.\n* Note 3: You may also link to a [[QualitativeValue]] node that provides additional information using [[valueReference]].\n* Note 4: Note that you can use [[minValue]] and [[maxValue]] to indicate ranges.
recipeYieldRecipeThe quantity produced by the recipe (for example, number of people served, number of servings, etc).
referenceQuantityUnitPriceSpecificationThe 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.
repetitionsExercisePlanNumber of times one should repeat the activity.
requiredQuantityHowToItemThe required quantity of the item(s).
restPeriodsExercisePlanHow often one should break from the activity.
roofLoadBusOrCoach or CarThe permitted total weight of cargo and installations (e.g. a roof rack) on top of the vehicle.\n\nTypical unit code(s): KGM for kilogram, LBR for pound\n\n* Note 1: You can indicate additional information in the [[name]] of the [[QuantitativeValue]] node.\n* Note 2: You may also link to a [[QualitativeValue]] node that provides additional information using [[valueReference]]\n* Note 3: Note that you can use [[minValue]] and [[maxValue]] to indicate ranges.
seatingCapacityVehicleThe number of persons that can be seated (e.g. in a vehicle), both in terms of the physical space available, and in terms of limitations set by law.\n\nTypical unit code(s): C62 for persons.
sizeCreativeWork or ProductA 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.
speedVehicleThe 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.\n\nTypical unit code(s): KMH for km/h, HM for mile per hour (0.447 04 m/s), KNT for knot\n\n*Note 1: Use [[minValue]] and [[maxValue]] to indicate the range. Typically, the minimal value is zero.\n* 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.
suggestedAgePeopleAudience or SizeSpecificationThe age or age range for the intended audience or person, for example 3-12 months for infants, 1-5 years for toddlers.
suggestedMeasurementPeopleAudience or SizeSpecificationA 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.
tongueWeightVehicleThe permitted vertical load (TWR) of a trailer attached to the vehicle. Also referred to as Tongue Load Rating (TLR) or Vertical Load Rating (VLR).\n\nTypical unit code(s): KGM for kilogram, LBR for pound\n\n* Note 1: You can indicate additional information in the [[name]] of the [[QuantitativeValue]] node.\n* Note 2: You may also link to a [[QualitativeValue]] node that provides additional information using [[valueReference]].\n* Note 3: Note that you can use [[minValue]] and [[maxValue]] to indicate ranges.
torqueEngineSpecificationThe torque (turning force) of the vehicle's engine.\n\nTypical unit code(s): NU for newton metre (N m), F17 for pound-force per foot, or F48 for pound-force per inch\n\n* Note 1: You can link to information about how the given value has been determined (e.g. reference RPM) using the [[valueReference]] property.\n* Note 2: You can use [[minValue]] and [[maxValue]] to indicate ranges.
trailerWeightVehicleThe permitted weight of a trailer attached to the vehicle.\n\nTypical unit code(s): KGM for kilogram, LBR for pound\n* Note 1: You can indicate additional information in the [[name]] of the [[QuantitativeValue]] node.\n* Note 2: You may also link to a [[QualitativeValue]] node that provides additional information using [[valueReference]].\n* Note 3: Note that you can use [[minValue]] and [[maxValue]] to indicate ranges.
transitTimeShippingConditions or ShippingDeliveryTimeThe typical delay the order has been sent for delivery and the goods reach the final customer. In the context of [[ShippingDeliveryTime]], use the [[QuantitativeValue]]. Typical properties: minValue, maxValue, unitCode (d for DAY). In the context of [[ShippingConditions]], use the [[ServicePeriod]]. It has a duration (as a [[QuantitativeValue]]) and also business days and a cut-off time.
valueReferencePropertyValue or QualitativeValue or QuantitativeValueA secondary value that provides additional information on the original value, e.g. a reference temperature or a type of measurement.
vehicleSeatingCapacityVehicleThe 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.\n\nTypical unit code(s): C62 for persons.
weightOfferShippingDetails or Person or Product or ShippingConditions or VisualArtworkThe weight of the product or person.
weightTotalVehicleThe permitted total weight of the loaded vehicle, including passengers and cargo and the weight of the empty vehicle.\n\nTypical unit code(s): KGM for kilogram, LBR for pound\n\n* Note 1: You can indicate additional information in the [[name]] of the [[QuantitativeValue]] node.\n* Note 2: You may also link to a [[QualitativeValue]] node that provides additional information using [[valueReference]].\n* Note 3: Note that you can use [[minValue]] and [[maxValue]] to indicate ranges.
wheelbaseVehicleThe distance between the centers of the front and rear wheels.\n\nTypical unit code(s): CMT for centimeters, MTR for meters, INH for inches, FOT for foot/feet.
widthMediaObject or OfferShippingDetails or Product or ShippingConditions or VisualArtworkThe width of the item.
workloadExercisePlanQuantitative measure of the physiologic output of the exercise; also referred to as energy expenditure.
yearlyRevenueBusinessAudienceThe size of the business in annual revenue.
yearsInOperationBusinessAudienceThe age of the business.
yieldHowToThe quantity that results by performing instructions. For example, a paper airplane, 10 personalized candles.

Properties usable on QuantitativeValue (20)

This list includes properties whose domainIncludes names QuantitativeValue or one of its ancestors. DomainIncludes is advisory; it is not an exhaustive set of permitted properties.

PropertyExpected value typesDescription
additionalPropertyPropertyValueA 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.\n\nNote: 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.
additionalTypeText, URLAn 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 <a href="https://schema.org/docs/styleguide.html">style guide</a>.
alternateNameTextAn alias for the item.
descriptionText, TextObjectA description of the item.
disambiguatingDescriptionTextA 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.
identifierPropertyValue, Text, URLThe 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](/docs/datamodel.html#identifierBg) for more details.
imageImageObject, URLAn image of the item. This can be a [[URL]] or a fully described [[ImageObject]].
mainEntityOfPageCreativeWork, URLIndicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.
maxValueNumberThe upper value of some characteristic or property.
minValueNumberThe lower value of some characteristic or property.
nameTextThe name of the item.
ownerOrganization, PersonA person or organization who owns this Thing.
potentialActionActionIndicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
sameAsURLURL 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.
subjectOfCreativeWork, EventA CreativeWork or Event about this Thing.
unitCodeText, URLThe 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.
unitTextTextA string or text indicating the unit of measurement. Useful if you cannot provide a standard unit code for <a href='unitCode'>unitCode</a>.
urlURLURL of the item.
valueBoolean, Number, QualitativeValue, StructuredValue, TextThe value of a [[QuantitativeValue]] (including [[Observation]]) or property value node.\n\n* For [[QuantitativeValue]] and [[MonetaryAmount]], the recommended type for values is 'Number'.\n* For [[PropertyValue]], it can be 'Text', 'Number', 'Boolean', 'StructuredValue' or 'QualitativeValue'.\n* Use values from 0123456789 (Unicode 'DIGIT ZERO' (U+0030) to 'DIGIT NINE' (U+0039)) rather than superficially similar Unicode symbols.\n* Use '.' (Unicode 'FULL STOP' (U+002E)) rather than ',' to indicate a decimal point. Avoid using these symbols as a readability separator.
valueReferenceDefinedTerm, Enumeration, MeasurementTypeEnumeration, PropertyValue, QualitativeValue, QuantitativeValue, StructuredValue, TextA secondary value that provides additional information on the original value, e.g. a reference temperature or a type of measurement.

Schema.org vs Google

This type's presence in Schema.org is not a Google feature approval. Check our dated Google status snapshot and Google's official Rich Results Test separately.

← Back to Schema Explorer