HealthPlanCostSharingSpecification

HealthPlanCostSharingSpecification is an Intangible for the detailed cost-sharing structure of a HealthInsurancePlan. It adds 5 direct properties:

healthPlanCopay (PriceSpecification): flat copay amount.
healthPlanCopayOption (Text): when the copay applies ("after deductible", "before deductible").
healthPlanCoinsuranceRate (Number): coinsurance percentage as a fraction (0.20 for 20%).
healthPlanCoinsuranceOption (Text): when the coinsurance applies.
healthPlanPharmacyCategory (Text): pharmacy-category scope ("mail-order", "retail", "specialty").

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

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

Highlight legend:Required by GoogleRecommendedOptional

schema.org/HealthPlanCostSharingSpecification

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HealthPlanCostSharingSpecification",
  "healthPlanPharmacyCategory": "retail (30-day supply)",
  "healthPlanCopay": { "@type": "PriceSpecification", "price": 5.00, "priceCurrency": "USD" },
  "healthPlanCopayOption": "after deductible",
  "healthPlanCoinsuranceRate": 0,
  "healthPlanCoinsuranceOption": "n/a (flat copay)"
}
</script>

Minimal valid version

The smallest markup that still produces a valid HealthPlanCostSharingSpecification 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/HealthPlanCostSharingSpecification (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HealthPlanCostSharingSpecification",
  "healthPlanCopay": { "@type": "PriceSpecification", "price": 5.00, "priceCurrency": "USD" }
}
</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.

No dedicated rich result
Google docs

Common HealthPlanCostSharingSpecification 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
coinsurance as percent string
Wrong
```
"healthPlanCoinsuranceRate": "20%"
```
Right
```
"healthPlanCoinsuranceRate": 0.20 (Number as fraction)
```
Fraction form is machine-computable; percent strings are not.

Schema properties in this example

HealthPlanCostSharingSpecification Intangible healthPlanPharmacyCategory healthPlanCopay PriceSpecification price priceCurrency healthPlanCopayOption healthPlanCoinsuranceRate healthPlanCoinsuranceOption

Also mentioned in 1 other example

HealthPlanCostSharingSpecification also appears in HealthPlanFormulary. See the full HealthPlanCostSharingSpecification schema page for every reference.

About the example data

Tier 1 (generic) retail pharmacy cost-sharing under the Dunmora PPO Gold 2026 plan.

Comments

Loading comments...