FinancialIncentive

additionalType

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 <a href="https://schema.org/docs/styleguide.html">style guide</a>.

Property

Comment: 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 <a href="https://schema.org/docs/styleguide.html">style guide</a>.
DomainIncludes: Thing
Label: additionalType
RangeIncludes: Text; URL
SubPropertyOf: type

alternateName

An alias for the item.

Property

Comment: An alias for the item.
DomainIncludes: Thing
Label: alternateName
RangeIncludes: Text

areaServed

The geographic area where a service or offered item is provided.

Property

Comment: The geographic area where a service or offered item is provided.
DomainIncludes: ContactPoint; DeliveryChargeSpecification; Demand; FinancialIncentive; Offer; Organization; Service
Label: areaServed
RangeIncludes: AdministrativeArea; GeoShape; Place; Text

description

A description of the item.

Property

Comment: A description of the item.
DomainIncludes: Thing
EquivalentProperty: Description
Label: description
RangeIncludes: Text; TextObject

disambiguatingDescription

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.

Property

Comment: 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.
DomainIncludes: Thing
Label: disambiguatingDescription
RangeIncludes: Text
SubPropertyOf: description

eligibleWithSupplier

The supplier of the incentivized item/service for which the incentive is valid for such as a utility company, merchant, or contractor.

Property

Comment: The supplier of the incentivized item/service for which the incentive is valid for such as a utility company, merchant, or contractor.
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: eligibleWithSupplier
RangeIncludes: Organization
Source: 3572

FinancialIncentive

Represents financial incentives for goods/services offered by an organization (or individual). Typically contains the [[name]] of the incentive, the [[incentivizedItem]], the [[incentiveAmount]], the [[incentiveStatus]], [[incentiveType]], the [[provider]] of the incentive, and [[eligibleWithSupplier]]. Optionally contains criteria on whether the incentive is limited based on [[purchaseType]], [[purchasePriceLimit]], [[incomeLimit]], and the [[qualifiedExpense]].

Class

Comment: Represents financial incentives for goods/services offered by an organization (or individual). Typically contains the [[name]] of the incentive, the [[incentivizedItem]], the [[incentiveAmount]], the [[incentiveStatus]], [[incentiveType]], the [[provider]] of the incentive, and [[eligibleWithSupplier]]. Optionally contains criteria on whether the incentive is limited based on [[purchaseType]], [[purchasePriceLimit]], [[incomeLimit]], and the [[qualifiedExpense]].
IsPartOf: pending.schema.org
Label: FinancialIncentive
Source: 3572
SubClassOf: Intangible

identifier

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](/docs/datamodel.html#identifierBg) for more details.

Property

Comment: 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](/docs/datamodel.html#identifierBg) for more details.
DomainIncludes: Thing
EquivalentProperty: Identifier
Label: identifier
RangeIncludes: PropertyValue; Text; URL

image

An image of the item. This can be a [[URL]] or a fully described [[ImageObject]].

Property

Comment: An image of the item. This can be a [[URL]] or a fully described [[ImageObject]].
DomainIncludes: Thing
Label: image
RangeIncludes: ImageObject; URL

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" } [[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": "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: <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>.

Property

Comment: 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" } [[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": "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: <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>.
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: incentiveAmount
RangeIncludes: LoanOrCredit; QuantitativeValue; UnitPriceSpecification
Source: 3572

incentiveStatus

The status of the incentive (active, on hold, retired, etc.).

Property

Comment: The status of the incentive (active, on hold, retired, etc.).
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: incentiveStatus
RangeIncludes: IncentiveStatus
Source: 3572

incentiveType

The type of incentive offered (tax credit/rebate, tax deduction, tax waiver, subsidies, etc.).

Property

Comment: The type of incentive offered (tax credit/rebate, tax deduction, tax waiver, subsidies, etc.).
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: incentiveType
RangeIncludes: IncentiveType
Source: 3572

incentivizedItem

The type or specific product(s) and/or service(s) being incentivized. DefinedTermSets are used for product and service categories such as the United Nations Standard Products and Services Code: { "@type": "DefinedTerm", "inDefinedTermSet": "https://www.unspsc.org/", "termCode": "261315XX", "name": "Photovoltaic module" } For a specific product or service, use the Product type: { "@type": "Product", "name": "Kenmore White 17" Microwave", } For multiple different incentivized items, use multiple [[DefinedTerm]] or [[Product]].

Property

Comment: The type or specific product(s) and/or service(s) being incentivized. DefinedTermSets are used for product and service categories such as the United Nations Standard Products and Services Code: { "@type": "DefinedTerm", "inDefinedTermSet": "https://www.unspsc.org/", "termCode": "261315XX", "name": "Photovoltaic module" } For a specific product or service, use the Product type: { "@type": "Product", "name": "Kenmore White 17" Microwave", } For multiple different incentivized items, use multiple [[DefinedTerm]] or [[Product]].
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: incentivizedItem
RangeIncludes: DefinedTerm; Product
Source: 3572

incomeLimit

Optional. Income limit for which the incentive is applicable for. If MonetaryAmount is specified, this should be based on annualized income (e.g. if an incentive is limited to those making <$114,000 annually): { "@type": "MonetaryAmount", "maxValue": 114000, "currency": "USD", } Use Text for incentives that are limited based on other criteria, for example if an incentive is only available to recipients making 120% of the median poverty income in their area.

Property

Comment: Optional. Income limit for which the incentive is applicable for. If MonetaryAmount is specified, this should be based on annualized income (e.g. if an incentive is limited to those making <$114,000 annually): { "@type": "MonetaryAmount", "maxValue": 114000, "currency": "USD", } Use Text for incentives that are limited based on other criteria, for example if an incentive is only available to recipients making 120% of the median poverty income in their area.
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: incomeLimit
RangeIncludes: MonetaryAmount; Text
Source: 3572

Intangible

A utility class that serves as the umbrella for a number of 'intangible' things such as quantities, structured values, etc.

Class

Comment: A utility class that serves as the umbrella for a number of 'intangible' things such as quantities, structured values, etc.
Label: Intangible
SubClassOf: Thing

mainEntityOfPage

Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.

Property

Comment: Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details.
DomainIncludes: Thing
InverseOf: mainEntity
Label: mainEntityOfPage
RangeIncludes: CreativeWork; URL

name

The name of the item.

Property

Comment: The name of the item.
DomainIncludes: Thing
EquivalentProperty: Title
Label: name
RangeIncludes: Text
SubPropertyOf: label

potentialAction

Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.

Property

Comment: Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
DomainIncludes: Thing
Label: potentialAction
RangeIncludes: Action

provider

The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller.

Property

Comment: The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller.
DomainIncludes: Action; CreativeWork; EducationalOccupationalProgram; FinancialIncentive; Invoice; ParcelDelivery; Reservation; Service; Trip
IsPartOf: pending.schema.org
Label: provider
RangeIncludes: Organization; Person
Source: 2289; 2927

publisher

The publisher of the article in question.

Property

Comment: The publisher of the article in question.
DomainIncludes: CreativeWork; FinancialIncentive
Label: publisher
RangeIncludes: Organization; Person

purchasePriceLimit

Optional. The maximum price the item can have and still qualify for this offer.

Property

Comment: Optional. The maximum price the item can have and still qualify for this offer.
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: purchasePriceLimit
RangeIncludes: MonetaryAmount
Source: 3572

purchaseType

Optional. The type of purchase the consumer must make in order to qualify for this incentive.

Property

Comment: Optional. The type of purchase the consumer must make in order to qualify for this incentive.
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: purchaseType
RangeIncludes: PurchaseType
Source: 3572

qualifiedExpense

Optional. The types of expenses that are covered by the incentive. For example some incentives are only for the goods (tangible items) but the services (labor) are excluded.

Property

Comment: Optional. The types of expenses that are covered by the incentive. For example some incentives are only for the goods (tangible items) but the services (labor) are excluded.
DomainIncludes: FinancialIncentive
IsPartOf: pending.schema.org
Label: qualifiedExpense
RangeIncludes: IncentiveQualifiedExpenseType
Source: 3572

sameAs

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.

Property

Comment: 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.
DomainIncludes: Thing
Label: sameAs
RangeIncludes: URL