Org.AI FoundationSchemaPartner

incentiveAmount

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": "QuantitativeValue", “minValue”: 2500, “maxValue”: 7500, "unitCode": "USD" }

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:

{ "@type": "QuantitativeValue", "value": 30, "unitCode": "P1", "unitText": "%", “maxValue”: 7500, “valueReference”: “USD” }

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": "UnitPriceSpecification", "price": 10, "priceCurrency": "USD", "referenceQuantity": 1, "unitCode": "DO3", "unitText": "kw/h", "maxPrice": 1000, "description": "$10 / kwh up to $1000" }

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": "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:

  • Use QuantitativeValue for absolute/percentage-based incentives applied on the price of a good/service.

.

Value
LoanOrCredit, QuantitativeValue or UnitPriceSpecification
Used on
FinancialIncentive
Source
Schema.org 30.1

JSON-LDMarkdown

A FinancialIncentive can have an incentiveAmount, and its value is a LoanOrCredit, a QuantitativeValue or a UnitPriceSpecification.

Used on

One type has an incentiveAmount, and so does every type that descends from it.

Its value

Its value is one of these 3 types.

Where this comes from

Quoted from Schema.org, and credited. Nothing in this definition is written by us.

  1. Published by
  2. Release
    Version 30.116 September 2026
  3. Proposed in
  4. License
    CC BY-SA 3.0Free to copy and adapt, with credit, under the same licence
  5. Changed by us
    Nothing.

Use this property

Its definition is free to reuse, with credit to Schema.org. The same property is here as data, for programs and for language models.

Partner with us

Fund the next pass, contribute data, or build on the record. Tell us what you have in mind.

Partner with us