TemporalProgression

A sequence of stages that occur over time, showing how a condition, treatment response, or biological process evolves with distinct characteristics at each phase.

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

Namespace: hs:

Category: Temporal Progressions

Properties

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

Property	Expected Type	Description
name	Text	Name of the temporal sequence (e.g., "Hair Loss and Recovery Timeline")
description	Text	Overview of the progression and what it describes
stages	TemporalStage	Ordered list of time-based stages in the progression
totalDuration	Duration	Overall timeline from start to finish (ISO 8601 format)
relativeToEvent	Text	If timing is relative to a specific event (e.g., "weight stabilization", "treatment initiation")

Examples

Example 1: Simple Recovery Timeline

A basic implementation showing essential structure:

JSON-LD

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "TemporalProgression": "hs:TemporalProgression",
      "TemporalStage": "hs:TemporalStage"
    }
  ],
  "@type": "TemporalProgression",
  "name": "Post-Surgery Recovery Timeline",
  "description": "Typical recovery progression following minor outpatient surgery",
  "totalDuration": "P6W",
  "stages": [
    {
      "@type": "TemporalStage",
      "stageName": "Immediate post-operative",
      "timepoint": "P0D",
      "event": "Wound healing begins",
      "recommendedActions": "Rest, pain management, wound care"
    },
    {
      "@type": "TemporalStage",
      "stageName": "Early recovery",
      "timepoint": "P1W",
      "event": "Return to light activities",
      "recommendedActions": "Gradual increase in movement"
    },
    {
      "@type": "TemporalStage",
      "stageName": "Full recovery",
      "timepoint": "P6W",
      "event": "Return to normal activities",
      "recommendedActions": "Resume all activities"
    }
  ]
}

Example 2: Detailed Hair Loss and Recovery Timeline

A comprehensive example showing the complete journey from treatment initiation through full recovery:

JSON-LD

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "TemporalProgression": "hs:TemporalProgression",
      "TemporalStage": "hs:TemporalStage"
    }
  ],
  "@type": "TemporalProgression",
  "name": "Mounjaro Hair Loss and Recovery Timeline",
  "description": "Complete progression from treatment initiation through hair shedding, stabilization, and full regrowth",
  "totalDuration": "P18M",
  "relativeToEvent": "Weight stabilization is the key turning point for recovery",
  "stages": [
    {
      "@type": "TemporalStage",
      "stageName": "Initial treatment phase",
      "timepoint": "P0M",
      "minValue": "P0M",
      "maxValue": "P2M",
      "event": "Beginning Mounjaro treatment with rapid weight loss",
      "physiologicalState": "Active weight loss, metabolic adaptation occurring",
      "patientExperience": "No visible hair changes yet, focusing on weight loss progress",
      "emotionalImpact": "Positive due to weight loss results",
      "recommendedActions": [
        "Begin high-protein diet (minimum 1g per kg body weight)",
        "Start multivitamin with iron and biotin",
        "Establish baseline hair photos"
      ],
      "significance": "Prevention is most effective when started early",
      "applicableTo": "100% of patients"
    },
    {
      "@type": "TemporalStage",
      "stageName": "Early shedding onset",
      "timepoint": "P2M",
      "minValue": "P2M",
      "maxValue": "P4M",
      "relativeToStabilization": false,
      "event": "First noticeable increase in hair shedding",
      "physiologicalState": "Hair follicles transitioning from anagen to telogen phase due to nutritional stress",
      "patientExperience": "More hair in shower drain and on pillow, may not connect to Mounjaro yet",
      "emotionalImpact": "Mild concern, often dismissed as seasonal",
      "recommendedActions": [
        "Continue protein supplementation",
        "Consider PRP therapy consultation",
        "Document shedding with daily counts"
      ],
      "criticalDecisionPoint": "Early intervention improves outcomes",
      "significance": "Window of opportunity for preventive measures",
      "applicableTo": {
        "@type": "QuantitativeValue",
        "value": "60",
        "unitText": "percent of patients"
      }
    },
    {
      "@type": "TemporalStage",
      "stageName": "Peak shedding phase",
      "timepoint": "P4M",
      "minValue": "P3M",
      "maxValue": "P6M",
      "event": "Maximum rate of hair loss, most noticeable thinning",
      "physiologicalState": "Synchronized telogen follicles releasing hair shafts",
      "patientExperience": "Visible scalp thinning, significant emotional distress, consideration of stopping treatment",
      "emotionalImpact": "Anxiety, frustration, fear of permanent loss",
      "recommendedActions": [
        "Begin PRP therapy if not already started (3-4 sessions)",
        "Increase protein to 1.2-1.5g per kg",
        "Consider low-level laser therapy",
        "Psychological support if needed"
      ],
      "criticalDecisionPoint": "Many patients consider stopping Mounjaro - education about temporary nature is critical",
      "significance": "Most challenging phase psychologically, but indicates pathway is active not permanent damage",
      "applicableTo": {
        "@type": "QuantitativeValue",
        "value": "75",
        "unitText": "percent of those experiencing shedding"
      }
    },
    {
      "@type": "TemporalStage",
      "stageName": "Shedding plateau",
      "timepoint": "P6M",
      "minValue": "P4M",
      "maxValue": "P8M",
      "event": "Shedding rate begins to slow",
      "physiologicalState": "Weight stabilizing, metabolic stress reducing",
      "patientExperience": "Less hair loss than peak, but still more than baseline",
      "emotionalImpact": "Cautious optimism, looking for signs of regrowth",
      "recommendedActions": [
        "Continue PRP if started",
        "Maintain nutritional support",
        "Begin minoxidil if needed for additional support"
      ],
      "significance": "Transition point - body adapting to new weight",
      "applicableTo": {
        "@type": "QuantitativeValue",
        "value": "90",
        "unitText": "percent when weight stabilizes"
      }
    },
    {
      "@type": "TemporalStage",
      "stageName": "Early regrowth phase",
      "timepoint": "P9M",
      "minValue": "P6M",
      "maxValue": "P12M",
      "relativeToStabilization": true,
      "event": "New baby hairs visible along hairline and part",
      "physiologicalState": "Follicles returning to anagen phase, new growth cycle beginning",
      "patientExperience": "Short, fine new hairs appearing (often called 'baby hairs')",
      "emotionalImpact": "Relief and encouragement, patience required as hairs are still short",
      "recommendedActions": [
        "Continue nutritional support",
        "Gentle hair care to protect new growth",
        "Document regrowth with photos"
      ],
      "significance": "Confirms recovery is progressing, but density not yet restored",
      "applicableTo": {
        "@type": "QuantitativeValue",
        "value": "85",
        "unitText": "percent of patients"
      }
    },
    {
      "@type": "TemporalStage",
      "stageName": "Progressive regrowth",
      "timepoint": "P12M",
      "minValue": "P9M",
      "maxValue": "P15M",
      "event": "New hairs lengthening, density improving",
      "physiologicalState": "Normal hair cycle restored, follicles functioning optimally",
      "patientExperience": "Visible improvement in density, styling becoming easier",
      "emotionalImpact": "Confidence returning, patience with final stages",
      "recommendedActions": [
        "Maintain healthy diet",
        "Can reduce intensive treatments",
        "Focus on hair health maintenance"
      ],
      "significance": "Substantial recovery achieved",
      "applicableTo": {
        "@type": "QuantitativeValue",
        "value": "80",
        "unitText": "percent reaching this stage"
      }
    },
    {
      "@type": "TemporalStage",
      "stageName": "Full recovery",
      "timepoint": "P18M",
      "minValue": "P12M",
      "maxValue": "P24M",
      "event": "Hair returns to pre-Mounjaro baseline density and quality",
      "physiologicalState": "Complete restoration of normal hair cycle",
      "patientExperience": "Hair looks and feels normal again, shedding returns to baseline",
      "emotionalImpact": "Relief and confidence fully restored",
      "recommendedActions": [
        "Continue general hair health practices",
        "Monitor if weight loss medications continue"
      ],
      "significance": "Confirms telogen effluvium was temporary and reversible",
      "applicableTo": {
        "@type": "QuantitativeValue",
        "value": "70-80",
        "unitText": "percent of patients"
      }
    }
  ]
}

Usage Notes

When to Use TemporalProgression

Use TemporalProgression when your content describes:

Multi-phase timelines — Processes that evolve through distinct stages with different characteristics
Recovery journeys — Treatment responses that progress through identifiable phases
Disease progression — How conditions develop or advance over time
Treatment protocols — Step-by-step treatment plans where timing matters
Patient experiences — What patients notice and feel changes across different phases

When to Use Schema.org Instead

Do NOT use TemporalProgression for simple time-based information. Use standard schema.org properties:

Single events — Use Event type with startDate and endDate
Treatment duration — Use duration property on MedicalProcedure
Simple timelines — Use ItemList with ordered items

Common Patterns

Relative vs. Absolute Timing

Use relativeToEvent when timing depends on a patient-specific milestone rather than absolute time:

"relativeToEvent": "Weight stabilization",
"relativeToStabilization": true

This acknowledges that patients reach milestones at different times, making absolute timeframes less useful.

Best Practices

Use time ranges — Include both minValue and maxValue to reflect individual variation
Capture patient experience — Use patientExperience and emotionalImpact to help patients recognize their stage
Include actionable guidance — Use recommendedActions to provide stage-specific advice
Highlight decision points — Use criticalDecisionPoint for stages requiring patient choices
Indicate applicability — Use applicableTo with percentages to set realistic expectations
Add significance — Use significance to explain why each stage matters

Related Types

Health Schema Types

Schema.org Types

MedicalCondition — Use to describe what condition is progressing
MedicalProcedure — Use for treatment procedures at each stage
Action — Use within recommendedActions
Duration — Use for time values (ISO 8601 format)