modifiable

Indicates whether a contributing factor can be changed through intervention. Accepts true, false, or "partial" to guide clinical decision-making about where to focus efforts.

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

Why This Property Exists

When modelling multifactorial conditions, not all contributing factors are equal from a clinical perspective. Some factors can be changed through intervention (diet, medication adherence), some cannot (age, genetics), and some fall in between (chronic conditions that can be managed but not eliminated).

This distinction is critical for:

Schema.org's MedicalRiskFactor can identify risk factors but provides no way to indicate whether they're actionable. The modifiable property fills this gap.

Domain and Range

Used On (Domain)

Type Context
hs:ContributingFactor Primary use. Indicates whether this factor can be changed to influence the outcome of a MultifactorialCondition.

Expected Values (Range)

Type Notes
schema:Boolean true or false for clear-cut cases
schema:Text The string "partial" for factors that can be influenced but not eliminated

Value Semantics

The three-state system captures the clinical reality that modifiability isn't always binary:

Value Meaning Clinical Implication Examples
true Factor can be eliminated or substantially changed Direct intervention target; often first priority Protein intake, medication timing, smoking cessation
false Factor cannot be changed Must be accommodated, not targeted; adjust expectations Age, genetic predisposition, biological sex
"partial" Factor can be influenced but not eliminated Management possible; complete resolution unlikely Chronic conditions (diabetes control), stress levels, baseline tissue health

Why "partial" Instead of a Scale

We considered a numeric scale (0-1) or enumeration (none/low/moderate/high) but found that:

Usage Guidance

Do

Don't

Edge Cases

Examples

Example 1: Clearly Modifiable Factor

Protein intake in hair loss risk:

{
  "@type": "ContributingFactor",
  "factorName": "Inadequate protein intake",
  "importance": "Major",
  "factor": {
    "@type": "MedicalRiskFactor",
    "name": "Protein intake below 1.2 g/kg daily"
  },
  "mechanism": "Hair is 90% protein (keratin); insufficient protein means follicles lack building blocks for hair shaft synthesis",
  "modifiable": true,
  "interventions": [
    "Calculate individual requirements: 1.2-2.0 g/kg daily",
    "Track intake meticulously for at least 3 days",
    "Consider protein supplementation if whole food intake insufficient"
  ]
}

Why true: Protein intake is entirely within patient control. The intervention is clear, measurable, and directly addressable.

Example 2: Non-Modifiable Factor

Female gender in GLP-1 medication hair loss:

{
  "@type": "ContributingFactor",
  "factorName": "Female gender",
  "importance": "Major",
  "factor": {
    "@type": "MedicalRiskFactor",
    "name": "Female gender, especially post-menopausal"
  },
  "mechanism": "Hormonal complexity with less margin for error in sex hormone balance; rapid weight loss affects SHBG levels altering free testosterone",
  "prevalence": "7.1% of females vs 0.5% of males in clinical trials; 14-fold increased risk",
  "modifiable": false
}

Why false: Biological sex cannot be changed. This factor must be accommodated in treatment planning, not targeted for intervention. Note there's no interventions property—there's nothing to do about this factor directly.

Example 3: Partially Modifiable Factor

Chronic health conditions affecting treatment response:

{
  "@type": "ContributingFactor",
  "factorName": "Chronic health conditions",
  "importance": "Moderate",
  "factor": {
    "@type": "MedicalRiskFactor",
    "name": "Conditions affecting healing capacity"
  },
  "mechanism": "Poorly controlled diabetes impairs multiple aspects of wound healing and tissue regeneration; conditions affecting circulation, immunity, or cellular metabolism reduce tissue responsiveness to growth factors",
  "modifiable": "partial",
  "interventions": [
    "Optimisation of underlying health conditions prior to treatment",
    "May require longer treatment courses or additional sessions"
  ]
}

Why "partial": The chronic condition itself cannot be eliminated, but its impact on treatment outcomes can be reduced through better disease management. The patient can improve glycaemic control, but they cannot cure their diabetes.

Example 4: Modifiable with Caveats

Medication effects on platelet function:

{
  "@type": "ContributingFactor",
  "factorName": "Medication effects",
  "importance": "Moderate",
  "factor": {
    "@type": "MedicalRiskFactor",
    "name": "Antiplatelet or anticoagulant medications"
  },
  "mechanism": "Aspirin irreversibly inhibits COX-1 enzymes in platelets, reducing aggregation and potentially affecting growth factor release",
  "modifiable": true,
  "interventions": [
    "Temporary discontinuation of medications (if medically safe) prior to treatment",
    "Timing of treatment relative to medication doses",
    "Requires physician approval—not all patients can safely discontinue"
  ]
}

Why true not "partial": The medication can be stopped entirely (unlike a chronic condition). The caveat about safety belongs in interventions, not in the modifiability classification.

Implementation Notes

JSON-LD Representation

Note that true and false are JSON booleans (no quotes), whilst "partial" is a string (with quotes):

// Boolean values - no quotes
"modifiable": true
"modifiable": false

// String value - with quotes
"modifiable": "partial"

Validation

Standard schema.org validators will not recognise this property. This is expected for Health Schema extensions. The property is defined in the Health Schema context and will be correctly interpreted by systems that load this context.

Querying Considerations

When building queries against data using this property, remember to handle all three value types:

A simple truthy check will incorrectly classify "partial" as modifiable.