CausalPathway

A multi-step mechanistic explanation showing how an initial cause leads to a final outcome through intermediate biochemical, physiological, or metabolic steps.

Canonical URL: https://healthschema.org/CausalPathway

Namespace: hs:

Category: Causal Mechanisms

Properties

Properties from CausalPathway (in addition to properties inherited from Intangible and Thing):

Property	Expected Type	Description
name	Text	Name of the causal pathway (e.g., "Mounjaro → Hair Loss Mechanism")
description	Text	Overview of the pathway and what it explains
initialCause	MedicalEntity or Thing	The starting point of the causal chain (e.g., a drug, lifestyle factor, or condition)
pathwaySteps	CausalStep	Ordered list of intermediate steps showing the mechanistic progression
finalOutcome	MedicalEntity or Thing	The end result of the pathway (e.g., a medical condition or symptom)
evidenceLevel	MedicalEvidenceLevel	Quality/strength of evidence supporting this pathway (A, B, C grading)
evidenceSource	ScholarlyArticle or CreativeWork	Citations linking this pathway to supporting research
limitations	Text	Important caveats, gaps in evidence, or boundaries of applicability

Examples

Example 1: Simple Causal Pathway

A basic implementation showing the essential structure:

JSON-LD

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "CausalPathway": "hs:CausalPathway",
      "CausalStep": "hs:CausalStep"
    }
  ],
  "@type": "CausalPathway",
  "name": "Rapid Weight Loss → Hair Shedding",
  "description": "Mechanistic explanation of how rapid weight loss triggers telogen effluvium",
  "initialCause": {
    "@type": "LifestyleModification",
    "name": "Rapid weight loss"
  },
  "pathwaySteps": [
    {
      "@type": "CausalStep",
      "stepNumber": 1,
      "mechanism": "Caloric deficit creates metabolic stress",
      "result": "Body enters conservation mode"
    },
    {
      "@type": "CausalStep",
      "stepNumber": 2,
      "mechanism": "Non-essential processes deprioritized",
      "result": "Hair growth shifts from anagen to telogen phase"
    }
  ],
  "finalOutcome": {
    "@type": "MedicalCondition",
    "name": "Telogen effluvium"
  }
}

Example 2: Detailed Mounjaro → Hair Loss Pathway

A comprehensive real-world example with full mechanistic detail and evidence:

JSON-LD

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "CausalPathway": "hs:CausalPathway",
      "CausalStep": "hs:CausalStep"
    }
  ],
  "@type": "CausalPathway",
  "name": "Mounjaro → Hair Loss Mechanistic Pathway",
  "description": "Multi-step biochemical explanation of how Mounjaro (tirzepatide) leads to temporary hair shedding through rapid weight loss and metabolic changes",
  "initialCause": {
    "@type": "Drug",
    "name": "Mounjaro",
    "activeIngredient": "Tirzepatide"
  },
  "pathwaySteps": [
    {
      "@type": "CausalStep",
      "stepNumber": 1,
      "mechanism": "GLP-1 receptor activation suppresses appetite and slows gastric emptying",
      "result": "Significantly reduced caloric intake",
      "biochemicalChanges": [
        "Increased satiety signaling",
        "Delayed nutrient absorption"
      ],
      "quantification": {
        "@type": "QuantitativeValue",
        "value": "500-1000",
        "unitText": "kcal daily deficit"
      },
      "evidenceLevel": {
        "@type": "MedicalEvidenceLevel",
        "evidenceLevel": "https://schema.org/EvidenceLevelA"
      },
      "citation": {
        "@type": "ScholarlyArticle",
        "name": "Efficacy and safety of tirzepatide in type 2 diabetes",
        "url": "https://doi.org/10.1056/NEJMoa2107519"
      }
    },
    {
      "@type": "CausalStep",
      "stepNumber": 2,
      "mechanism": "Sustained caloric deficit depletes protein, iron, and vitamin reserves",
      "result": "Nutritional deficiency state affecting hair follicles",
      "biochemicalChanges": [
        "Reduced serum ferritin",
        "Decreased bioavailable amino acids",
        "Lower B-vitamin levels"
      ],
      "timeDelay": "P4W",
      "evidenceLevel": {
        "@type": "MedicalEvidenceLevel",
        "evidenceLevel": "https://schema.org/EvidenceLevelA"
      }
    },
    {
      "@type": "CausalStep",
      "stepNumber": 3,
      "mechanism": "Nutritional stress triggers premature termination of anagen phase",
      "result": "Hair follicles shift from growth (anagen) to resting (telogen) phase",
      "biochemicalChanges": [
        "Reduced cellular metabolism in follicle",
        "Decreased keratinocyte proliferation"
      ],
      "timeDelay": "P2M",
      "evidenceLevel": {
        "@type": "MedicalEvidenceLevel",
        "evidenceLevel": "https://schema.org/EvidenceLevelB"
      },
      "citation": {
        "@type": "ScholarlyArticle",
        "name": "Nutritional factors and hair loss",
        "url": "https://doi.org/10.1111/jocd.13616"
      }
    },
    {
      "@type": "CausalStep",
      "stepNumber": 4,
      "mechanism": "Synchronized telogen follicles reach end of resting phase",
      "result": "Widespread shedding as new hair pushes out old shafts",
      "timeDelay": "P3M",
      "evidenceLevel": {
        "@type": "MedicalEvidenceLevel",
        "evidenceLevel": "https://schema.org/EvidenceLevelA"
      }
    }
  ],
  "finalOutcome": {
    "@type": "MedicalCondition",
    "name": "Telogen effluvium",
    "alternateName": "Temporary diffuse hair shedding"
  },
  "evidenceLevel": {
    "@type": "MedicalEvidenceLevel",
    "evidenceLevel": "https://schema.org/EvidenceLevelB"
  }
}

Usage Notes

When to Use CausalPathway

Use CausalPathway when your content explains:

Multi-step mechanisms — How something works through multiple biochemical, physiological, or metabolic transitions
Complex causation — Relationships that go beyond simple "A causes B" to show the intermediate steps
Pathophysiology — The underlying biological mechanisms of how conditions develop
Drug mechanisms — How medications produce their effects or side effects

When to Use Schema.org Instead

Do NOT use CausalPathway for simple causal relationships. Use standard schema.org properties:

Single-step causation — Use MedicalCondition with riskFactor property
Risk factors — Use MedicalRiskFactor type
Simple associations — Use associatedAnatomy, cause, or other standard properties

Common Patterns

Combining with Standard Schema.org

Always pair CausalPathway with standard MedicalCondition markup in a @graph:

{
  "@context": [...],
  "@graph": [
    {
      "@type": "MedicalCondition",
      "name": "Telogen effluvium",
      "riskFactor": {
        "@type": "MedicalRiskFactor",
        "name": "Rapid weight loss"
      }
    },
    {
      "@type": "CausalPathway",
      "name": "Weight loss → Hair loss mechanism",
      ...
    }
  ]
}

This ensures search engines can still process basic relationships while LLMs gain deeper mechanistic understanding.

Best Practices

Order steps logically — Use stepNumber to maintain correct sequence
Include time delays — Use timeDelay in CausalStep to show when each transition occurs
Cite evidence — Include citation and evidenceLevel for credibility
Be specific — Use biochemicalChanges to capture molecular-level detail
Quantify when possible — Use quantification for measurable aspects

Related Types

Health Schema Types

Schema.org Types

MedicalCondition — Use for the initial cause or final outcome
Drug — Use for pharmaceutical causes
MedicalRiskFactor — Use for simple risk associations
MedicalEvidenceLevel — Use for evidence strength
ScholarlyArticle — Use for citations