patientExperience

Description of what a patient observes, feels, or notices at a particular timepoint—their subjective experience of a TemporalStage. This captures visible changes, physical sensations, and functional impacts from the patient's perspective, complementing the physiologicalState which describes internal biological processes.

Canonical URL: https://healthschema.org/patientExperience
Namespace: hs:
Category: Property

Why This Property Exists

Patient-facing health content must bridge the gap between medical knowledge and lived experience. When describing treatment timelines or condition progression, patients want to know:

The patientExperience property provides this patient-centred perspective, enabling content that:

Domain and Range

Used On (Domain)

Type Context
hs:TemporalStage Primary use. Each stage in a temporal progression can describe the patient experience.

Expected Values (Range)

Type Notes
schema:Text Free text description from the patient's perspective. Use accessible language.

Distinction From Related Properties

Several TemporalStage properties capture different perspectives:

Property Perspective Example
patientExperience What the patient observes/feels "Noticeable improvement in volume; hair appears fuller; can be photographically documented"
physiologicalState What's happening biologically "Multiple follicles producing terminal hairs; improved vascularisation supporting growth"
emotionalImpact Psychological effects "Increased confidence; validation that recovery is occurring"
event The clinical milestone "Measurable increase in hair density"

The Key Test

If a patient could describe it without medical training—it's patient experience.
If understanding it requires medical knowledge—it's physiological state.

Usage Guidance

Do

Don't

Examples

Example 1: Treatment Initiation

Day of treatment:

{
  "@type": "TemporalStage",
  "stageName": "Treatment Administration",
  "timepoint": "Day 0",
  "event": "PRP or iPRF injection into scalp",
  "physiologicalState": "Growth factors released within hours; peak concentrations in first 24-72 hours",
  "patientExperience": "Mild discomfort during injection, possible temporary swelling or tenderness"
}

Example 2: Invisible Progress

When biology precedes visible change:

{
  "@type": "TemporalStage",
  "stageName": "Cellular Activation",
  "timepoint": {
    "@type": "QuantitativeValue",
    "minValue": 1,
    "maxValue": 7,
    "unitText": "days"
  },
  "event": "Target cells receive growth factor signals",
  "physiologicalState": "Fibroblasts and dermal papilla cells activate; gene expression changes begin",
  "patientExperience": "No visible changes; injection site resolves"
}

Why this works: Explicitly stating "no visible changes" reassures patients that the lack of immediate results is normal.

Example 3: Peak Distress

Most challenging stage of a condition:

{
  "@type": "TemporalStage",
  "stageName": "Peak shedding",
  "timepoint": {
    "@type": "QuantitativeValue",
    "minValue": 3,
    "maxValue": 6,
    "unitText": "months"
  },
  "event": "Maximum hair loss rate",
  "physiologicalState": "Highest proportion of follicles in synchronised shedding phase",
  "patientExperience": "Most noticeable thinning; may see visible scalp areas or widening part",
  "emotionalImpact": "Peak anxiety; may consider stopping medication"
}

Example 4: Visible Improvement

Positive changes become apparent:

{
  "@type": "TemporalStage",
  "stageName": "Visible Improvement",
  "timepoint": {
    "@type": "QuantitativeValue",
    "minValue": 3,
    "maxValue": 6,
    "unitText": "months"
  },
  "event": "Measurable increase in hair density",
  "physiologicalState": "Multiple follicles producing terminal hairs; improved vascularisation supporting growth; accumulated collagen in follicle environment",
  "patientExperience": "Noticeable improvement in coverage; hair appears fuller; can be photographically documented"
}

Example 5: Skin Treatment Response

Facial rejuvenation timeline:

{
  "@type": "TemporalStage",
  "stageName": "Collagen Maturation",
  "timepoint": {
    "@type": "QuantitativeValue",
    "minValue": 2,
    "maxValue": 3,
    "unitText": "months"
  },
  "event": "Collagen fibril assembly and cross-linking",
  "physiologicalState": "Newly synthesised collagen assembles into organised fibrils; enzymatic cross-linking creates stable structural network; dermal thickness increasing",
  "patientExperience": "Progressive improvement in firmness; fine lines softening; skin texture refining",
  "recommendedActions": ["Second treatment (if series of 3-4 planned) to amplify effects"]
}

Example 6: Complete Stage with All Properties

Comprehensive temporal stage:

{
  "@type": "TemporalStage",
  "stageName": "Hair loss onset",
  "timepoint": {
    "@type": "QuantitativeValue",
    "minValue": 2,
    "maxValue": 4,
    "unitText": "months"
  },
  "event": "Noticeable shedding begins",
  "physiologicalState": "Synchronised follicles completing telogen phase and shedding simultaneously; 300+ hairs daily lost",
  "patientExperience": "Sudden increase in hair in brush, shower drain; may notice less volume when styling",
  "emotionalImpact": "Anxiety and distress; may feel disconnected from cause due to delay",
  "recommendedActions": [
    "Assess nutrition immediately - track protein for 3 days",
    "Get comprehensive blood work if not done",
    "Minimise mechanical stress (gentle styling, wide-tooth combs)",
    "Begin documenting with monthly photos"
  ],
  "significance": "Most distressing phase psychologically due to visible changes"
}

Implementation Notes

Writing for Patients

Effective patientExperience descriptions:

JSON-LD Context

When using this property, ensure it's declared in your context:

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "patientExperience": "hs:patientExperience"
    }
  ]
}