LabValueCriterion

A criterion based on a laboratory test result with threshold value and comparison operator.

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

Namespace: hs:

Category: Conditional Recommendations

Properties

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

Property	Expected Type	Description
test	Text	Name of laboratory test
value	Number	Threshold value
comparator	Text	"LessThan", "GreaterThan", "EqualTo", or "Between"
unitText	Text	Unit of measurement (e.g., "ng/mL", "mmol/L", "percent")
rationale	Text	Why this threshold matters clinically

Examples

Example 1: Iron Deficiency Screening

JSON-LD

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "LabValueCriterion": "hs:LabValueCriterion"
    }
  ],
  "@type": "LabValueCriterion",
  "test": "Serum ferritin",
  "value": 30,
  "comparator": "LessThan",
  "unitText": "ng/mL",
  "rationale": "Low iron stores unable to support increased demands during rapid metabolic change"
}

Example 2: Glucose Control Assessment

JSON-LD

{
  "@context": [
    "https://schema.org",
    {
      "hs": "https://healthschema.org/",
      "LabValueCriterion": "hs:LabValueCriterion"
    }
  ],
  "@type": "LabValueCriterion",
  "test": "HbA1c",
  "value": 7.5,
  "comparator": "GreaterThan",
  "unitText": "percent",
  "rationale": "Indicates suboptimal glucose control requiring treatment intensification"
}

Usage Notes

Comparator Values

LessThan: Test result must be below threshold
GreaterThan: Test result must be above threshold
EqualTo: Test result must match threshold exactly
Between: Test result must fall within a range (use with min/max values)

Best Practices

Include units — Always specify unitText to avoid ambiguity
Explain significance — Use rationale to clarify why the threshold matters
Use standard test names — Reference commonly recognized lab test names

Related Types

Health Schema Types

Schema.org Types

MedicalTest — Can be used to describe the test itself