# 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 1. Go to **Administration → Manage Lab Services → Manage Investigations** tab → **Manage Investigations**. 2. Select the investigation and click **Flags**. The **Manage Flag** page opens. --- ## Adding a Flag 1. **Select Flag** (the flag field) and **Select Value** (the result field it checks). 2. 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. 3. 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](https://github.com/hmislk/hmis/wiki/LIMS-Result-Flags-and-Critical-Values) for the user-facing explanation. --- [Back to LIMS Administration](https://github.com/hmislk/hmis/wiki/LIMS-Administration)