Value Flags¶
A value flag is a rule attached to an investigation parameter that triggers a custom message when a result falls within a defined threshold. Unlike a standard reference range indicator (which simply shows H or L), flags can carry clinical messages — for example, "Show this result to the doctor immediately" or "Repeat the sample — value is critically high." Flags support age-based and sex-based filtering, so the same parameter can trigger different messages for different patient groups.
When to Use Flags¶
Use flags when:
- A result value is not just abnormal, but clinically critical and requires immediate action.
- You want to display a specific advisory message on the report rather than just an H/L indicator.
- Different age groups or sexes warrant different alert levels for the same parameter.
Accessing Flag Configuration¶
- Go to Administration → Manage Lab Services → Manage Investigations tab → Manage Investigations.
- Select the investigation and click Flags. The Manage Flag page opens.
Adding a Flag¶
- Select Flag (the flag field) and Select Value (the result field it checks).
- Fill in the trigger conditions and messages below.
Range and patient group¶
| Field | Description |
|---|---|
| Sex | Male or Female. A rule applies only to patients of that sex, so add one rule for each sex |
| From Age / To Age | The patient age range for this rule, in days (for example 6570 to 43800 for 18 to 120 years) |
| From Value / To Value | The normal range. Below From Value shows the low message; above To Value shows the high message; in between shows the within-range message |
Messages¶
| Field | When it is shown |
|---|---|
| Message if Low | The value is below From Value |
| Message if High | The value is above To Value |
| Message if Within the Range | The value is between the two |
For a text result, the high message is shown when the text matches the rule's Max Value, and the low message when it matches its Min Value. Set these in the Flag List columns after saving the rule.
- Click Save. The rule appears in the Flag List, where Filter by Flag shows only the rules for one flag and Remove deletes a rule.
Example: serum potassium, adults¶
Add two rules (one Male, one Female) with From Age 6570, To Age 43800, From Value 3.5, To Value 5.1, and:
- Message if Low: "L"
- Message if High: "H"
- Message if Within the Range: left empty
Several rules for one flag¶
Add more rules for other age groups. The first rule whose sex and age match the patient is used, so make the age ranges not overlap.
How Flags Appear During Result Entry¶
When an MLT enters a value that meets a flag condition:
- The matching message fills the flag field of the report.
- The MLT can still save and approve the report. Flags are informational; they do not block approval.
Flags and the "Requires Immediate Doctor Review" Toggle¶
Flags are separate from the manual Requires Immediate Doctor Review toggle. Flags are automatic (triggered by value thresholds); the toggle is manual (set by an authorised user after reviewing the result). Both can be active on the same report.
See Result Flags & Critical Values for the user-facing explanation.