FinancialIncentive

FinancialIncentive is an Intangible type for tax credits, rebates, deductions, subsidies, waivers, and loans offered by governments or organizations. It has 14 properties of its own, making it one of the more substantial newer types in schema.org. The key properties are incentiveType (what kind of incentive), incentiveStatus (active or retired), incentiveAmount (how much), incentivizedItem (what product or service qualifies), and validFrom/validThrough (when it applies).

The type hierarchy is Thing → Intangible → FinancialIncentive. Google reads this for government incentive programs: energy efficiency rebates, EV tax credits, solar panel subsidies, small business grants. The structured data helps Google surface incentive information in search results for product queries ("EV tax credit 2026") and government program pages.

Full example of schema.org/FinancialIncentive json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional

schema.org/FinancialIncentive

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@id": "https://pa.gov/incentives/structured-data-adoption-credit#incentive",
  "@type": "FinancialIncentive",
  "name": "Pennsylvania Structured Data Adoption Tax Credit",
  "description": "Tax credit for small businesses in Pennsylvania that implement schema.org structured data on their commercial websites. Up to $2,500 credit per business per year.",
  "url": "https://pa.gov/incentives/structured-data-adoption-credit",
  "incentiveType": "https://schema.org/IncentiveTypeTaxCredit",
  "incentiveStatus": "https://schema.org/IncentiveStatusActive",
  "incentiveAmount": {
    "@type": "QuantitativeValue",
    "maxValue": "2500",
    "unitCode": "USD"
  },
  "incentivizedItem": {
    "@type": "DefinedTerm",
    "name": "Schema.org structured data implementation",
    "description": "JSON-LD structured data added to a commercial website"
  },
  "areaServed": {
    "@type": "AdministrativeArea",
    "name": "Pennsylvania",
    "sameAs": "https://en.wikipedia.org/wiki/Pennsylvania"
  },
  "provider": {
    "@type": "GovernmentOrganization",
    "name": "Pennsylvania Department of Revenue",
    "url": "https://pa.gov/revenue"
  },
  "validFrom": "2026-01-01",
  "validThrough": "2026-12-31",
  "purchaseType": "https://schema.org/NewPurchase"
}
</script>

incentiveType

incentiveType takes an IncentiveType enum: IncentiveTypeTaxCredit, IncentiveTypeTaxDeduction, IncentiveTypeTaxWaiver, IncentiveTypeRebateOrSubsidy, or IncentiveTypeLoan. Use the full schema.org URL. This tells Google what kind of financial benefit the program offers.

incentiveStatus

incentiveStatus takes an IncentiveStatus enum: IncentiveStatusActive, IncentiveStatusOnHold, IncentiveStatusRetired, or IncentiveStatusInDevelopment. Programs change status. Mark retired programs so Google stops surfacing them for current searches.

incentiveAmount

incentiveAmount takes a QuantitativeValue, UnitPriceSpecification, or LoanOrCredit. For a flat tax credit ("$7,500 credit"), use QuantitativeValue with value and currency. For a percentage rebate ("30% of purchase price"), use UnitPriceSpecification with referenceQuantity. For a subsidized loan, use LoanOrCredit.

incentivizedItem and eligibility

incentivizedItem takes a Product or DefinedTerm describing what qualifies. incomeLimit sets an income ceiling. purchasePriceLimit sets a maximum purchase price. areaServed defines geographic eligibility. Together, these express who qualifies and for what.

FinancialIncentive vs FundingScheme

A FundingScheme is a grant program (an Organization subtype). A FinancialIncentive is a specific benefit (tax credit, rebate) that a consumer or business receives. A government might operate a FundingScheme that distributes FinancialIncentives. They are related but serve different purposes in the knowledge graph.

Minimal valid version

The smallest markup that still produces a valid FinancialIncentive entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/FinancialIncentive (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FinancialIncentive",
  "name": "Pennsylvania Structured Data Adoption Tax Credit",
  "incentiveType": "https://schema.org/IncentiveTypeTaxCredit",
  "incentiveStatus": "https://schema.org/IncentiveStatusActive",
  "incentiveAmount": { "@type": "QuantitativeValue", "maxValue": "2500", "unitCode": "USD" },
  "provider": { "@type": "GovernmentOrganization", "name": "Pennsylvania Department of Revenue" },
  "validFrom": "2026-01-01",
  "validThrough": "2026-12-31",
  "description": "Tax credit for small businesses implementing schema.org structured data."
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Government incentive result (indirect)
Google docs

Common FinancialIncentive mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
incentiveType as a plain description
Wrong
```
"incentiveType": "Tax credit for structured data adoption"
```
Right
```
"incentiveType": "https://schema.org/IncentiveTypeTaxCredit"
```
incentiveType takes an IncentiveType enum as a full schema.org URL. The five values are IncentiveTypeTaxCredit, IncentiveTypeTaxDeduction, IncentiveTypeTaxWaiver, IncentiveTypeRebateOrSubsidy, and IncentiveTypeLoan.
02
Missing incentiveStatus on a retired program
Wrong
```
FinancialIncentive for an expired program with no incentiveStatus
```
Right
```
"incentiveStatus": "https://schema.org/IncentiveStatusRetired"
```
Expired programs should be marked IncentiveStatusRetired so Google stops surfacing them for current searches. An incentive with no status defaults to ambiguous, and users may waste time applying for a dead program.
03
Missing validFrom and validThrough
Wrong
```
FinancialIncentive with no date boundaries
```
Right
```
"validFrom": "2026-01-01", "validThrough": "2026-12-31"
```
Most incentives are time-limited (tax year, fiscal year, legislative session). Without dates, there is no way to know if the incentive is current. Google may suppress incentive results without clear validity dates.
04
Confusing FinancialIncentive with FundingScheme
Wrong
```
"@type": "FundingScheme" for a consumer tax credit
```
Right
```
FinancialIncentive for credits/rebates received by consumers or businesses; FundingScheme for grant programs administered by organizations
```
FinancialIncentive is the benefit (a tax credit, a rebate). FundingScheme is the grant program. A government (FundingScheme operator) may offer a FinancialIncentive (the actual credit). They are different entities.

Schema properties in this example

FinancialIncentive name description url incentiveType IncentiveType incentiveStatus IncentiveStatus incentiveAmount QuantitativeValue incentivizedItem DefinedTerm areaServed AdministrativeArea provider GovernmentOrganization validFrom validThrough purchaseType

About the example data

A fictional Pennsylvania state tax credit for businesses that implement schema.org structured data on their websites. Xoo Code Inc. qualifies as the provider, and the XooStructured IDE is the incentivized product.

Comments

Loading comments...