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.
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:
- Clinical prioritisation: Focus intervention efforts where they can actually make a difference
- Patient counselling: Set realistic expectations about what can and cannot be changed
- Treatment planning: Design protocols that address modifiable factors whilst accounting for non-modifiable ones
- Risk stratification: Distinguish between actionable and inherent risk factors
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:
- Clinical decisions typically need categorical guidance, not granular scores
- The three states map directly to distinct clinical actions: target, accommodate, or manage
- More granularity would require evidence that often doesn't exist
Usage Guidance
Do
- Use
truefor directly actionable factors—things a patient or clinician can change through specific intervention - Use
falsefor inherent characteristics—things that are fixed or determined at birth/diagnosis - Use
"partial"when management is possible but elimination isn't—chronic conditions, lifestyle factors with biological constraints - Pair with
interventions—whenmodifiableistrueor"partial", specify what actions can be taken
Don't
- Omit for non-modifiable factors—explicitly stating
falseis informative; silence is ambiguous - Confuse difficulty with impossibility—smoking cessation is difficult but modifiable (
true); age is easy to understand but non-modifiable (false) - Use "partial" as a hedge—reserve it for genuinely intermediate cases, not uncertainty about whether something is modifiable
Edge Cases
- Medication effects: If a patient takes antiplatelet medications, is this modifiable? Use
truewith a caveat in theinterventionsnoting it requires physician approval and may not be safe for all patients. - Severe obesity: Technically modifiable but with significant barriers. Use
truebut acknowledge inmechanismorinterventionsthat sustained change is challenging. - Baseline tissue damage: Cannot be undone, but severity of future damage may be reduced. Use
"partial".
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:
- Boolean
true - Boolean
false - String
"partial"
A simple truthy check will incorrectly classify "partial" as modifiable.