XooCode(){

HealthInsurancePlan

HealthInsurancePlan is an Intangible for US-style health-insurance plans — PPO, EPO, HMO, POS, high-deductible. It adds 9 direct properties:

  • healthPlanId (Text): the plan identifier (CMS Plan ID for ACA plans).
  • healthPlanMarketingUrl (URL): the plan's marketing / enrolment page.
  • benefitsSummaryUrl (URL): the SBC (Summary of Benefits and Coverage) PDF.
  • usesHealthPlanIdStandard (Text or URL): identifier standard (e.g. the CMS HIOS Plan ID system).
  • healthPlanDrugOption (Text): how the plan covers drugs ("four-tier formulary", "mail-order mandatory for maintenance").
  • healthPlanDrugTier (Text): drug tier summary.
  • contactPoint (ContactPoint): member-services line.
  • includesHealthPlanFormulary (HealthPlanFormulary): the plan's drug formulary.
  • includesHealthPlanNetwork (HealthPlanNetwork): provider networks.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/HealthInsurancePlan
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HealthInsurancePlan",
  "@id": "https://dunmorahealth.example/plans/ppo-gold-2026",
  "name": "Dunmora PPO Gold 2026",
  "healthPlanId": "12345PA0010001-01",
  "healthPlanMarketingUrl": "https://dunmorahealth.example/plans/ppo-gold-2026",
  "benefitsSummaryUrl": "https://dunmorahealth.example/plans/ppo-gold-2026/sbc.pdf",
  "usesHealthPlanIdStandard": "https://www.cms.gov/CCIIO",
  "healthPlanDrugOption": "Four-tier formulary with mail-order for maintenance medications",
  "healthPlanDrugTier": "Tier 1 (generics) $5; Tier 2 (preferred brand) $30; Tier 3 (non-preferred brand) $60; Tier 4 (specialty) 30% coinsurance",
  "contactPoint": { "@type": "ContactPoint", "contactType": "member services", "telephone": "+1-570-555-0440", "availableLanguage": ["en", "es"] },
  "includesHealthPlanFormulary": { "@type": "HealthPlanFormulary", "healthPlanDrugOption": "Four-tier formulary" },
  "includesHealthPlanNetwork": [
    { "@type": "HealthPlanNetwork", "name": "Dunmora PPO Nationwide Network", "healthPlanNetworkId": "NET-DMH-PPO-001" }
  ]
}
</script>

Minimal valid version

The smallest markup that still produces a valid HealthInsurancePlan 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/HealthInsurancePlan (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "HealthInsurancePlan",
  "name": "Dunmora PPO Gold 2026",
  "healthPlanId": "12345PA0010001-01",
  "healthPlanMarketingUrl": "https://dunmorahealth.example/plans/ppo-gold-2026"
}
</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 (used by plan-comparison and CMS consumers)
    Google docs

Common HealthInsurancePlan 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.

  1. 01

    healthPlanId as a free-form name

    Wrong
    "healthPlanId": "Gold PPO"
    Right
    The formal CMS Plan ID

    healthPlanId is the regulatory identifier; marketing names go in name.

  2. 02

    Missing benefitsSummaryUrl

    Wrong
    HealthInsurancePlan with no SBC link
    Right
    benefitsSummaryUrl pointing to the SBC PDF

    The SBC is federally required; linking it structurally lets consumer consumers surface it.

Schema properties in this example

HealthInsurancePlanIntangiblenamehealthPlanIdhealthPlanMarketingUrlbenefitsSummaryUrlusesHealthPlanIdStandardhealthPlanDrugOptionhealthPlanDrugTiercontactPointContactPointcontactTypetelephoneavailableLanguageincludesHealthPlanFormularyHealthPlanFormularyincludesHealthPlanNetworkHealthPlanNetworkhealthPlanNetworkId

Also mentioned in 2 other examples

HealthInsurancePlan also appears in HealthPlanFormulary, and HealthPlanNetwork. See the full HealthInsurancePlan schema page for every reference.

About the example data

A fictional Dunmora National Health Alliance PPO plan offered on the individual marketplace.

Comments

Loading comments...

Leave a comment