Clinical patterns

Patient header

The persistent band that answers one question at all times: whose record am I looking at? It is the primary control against wrong-patient error, which is why it is never scrolled away, never collapsed, and never abbreviated.

Stable · v1.0 Pattern Wrong-patient control WCAG 2.2 AA AcuteLine

Overview

Wrong-patient error is among the most consequential and most under-designed failures in clinical software. It rarely happens because someone cannot read a name; it happens because a clinician was interrupted, returned to a screen they believed was one patient, and acted.

The patient header exists for that moment of return. It is not decoration and not a breadcrumb — it is a continuously visible assertion of identity, positioned where the eye lands before any clinical content.

Always present

Visible in every state of every patient-scoped screen. Never scrolled off, never behind a disclosure, never replaced by a modal's own title.

Complete

Name and full identifier in one glance, never truncated with an ellipsis. If the layout cannot fit the identity, the layout is wrong, not the identity.

Distinguishing

Shows the fields that separate this patient from a similar one — date of birth as well as name, because two people on one ward share surnames more often than designers expect.

Anatomy

Patient header · default
HARLAND, Arthur J.
MRN 44 812 907
Date of birth
1964-03-11 · 61 y
Sex
Male
Location
ED · Bay 4
Encounter
ENC-2026-08-13-0447
Allergy Anticoag
RegionContentsRule
Identity Family name, given name, full MRN Never truncated. Family name first and in caps so it is unambiguous across naming conventions.
Distinguishing fields Date of birth with derived age, sex, location, encounter Date of birth is mandatory — it is the field that separates two patients with the same name.
Flags Allergy, anticoagulation, isolation, care limitations Only facts that change immediate management. Not a general tag system.
Date of birth is not optional

Name plus MRN feels sufficient until two patients on the same ward share a surname and their MRNs differ by one transposed digit. Date of birth is the field a clinician actually cross-checks against a wristband, a chart or a colleague's verbal handover. It appears in the default configuration and cannot be removed by product configuration.

Variants

default

Full band across the top of a patient-scoped screen, directly beneath the application masthead and directly above any docked Alert Banner.

compact

Reduced padding for dense workstation layouts and secondary panels. Identity fields are unchanged — compact reduces whitespace, never information.

variant: compact
OKONKWO, Blessing
MRN 51 330 264
Date of birth
1971-09-02 · 54 y
Sex
Female
Location
ED · Bay 2
No known allergies

In context

The header sits above the alert region, so identity is read before the finding. Reversing that order means a clinician can read "STEMI detected" before they know whose it is.

Header + docked alert · reading order
HARLAND, Arthur J.
MRN 44 812 907
Date of birth
1964-03-11 · 61 y
Location
ED · Bay 4
Allergy

Context change

The single highest-risk moment for this component is when the record underneath it changes. Three rules govern it:

Stale context after inactivity

After a documented idle period the header enters a confirm identity state: the record stays visible and readable, but write actions are suspended until the clinician re-confirms which patient they are on. This is the direct control against the interrupted clinician returning to a screen and acting on the wrong record.

Stale context · write actions suspended
HARLAND, Arthur J.
MRN 44 812 907
Date of birth
1964-03-11 · 61 y
Location
ED · Bay 4
Confirm you are still working on this patient
No activity for 15 minutes. Recording and ordering are suspended until you confirm.

Formatting rules

Do
DELACROIX, Marie-Louise
MRN 47 120 883
Date of birth
1957-12-04 · 68 y

Long name wraps the layout, not the identity. ISO date, grouped MRN.

Don't
Delacroix, Marie-L…
…0883
DOB
04/12/57

Truncated name, partial MRN, and a date that reads as 4 December or 12 April depending on where you trained.

Do's and don'ts

Do
HARLAND, Arthur J.
MRN 44 812 907
Date of birth
1964-03-11 · 61 y

Date of birth present and in ISO form. It is the field clinicians cross-check against a wristband.

Don't
HARLAND, Arthur J.
MRN 44 812 907
Location
ED · Bay 4

No date of birth. Two Arthur Harlands on the ward are now separated only by a nine-digit number.

Accessibility

Outcomes of use

What this contributes to, in the terms of Usability & context of use. These are attributes believed to contribute to an outcome; the outcome itself is settled by observing real use in a specified context, not by this page.

Clinical safety notes

Risk controls carried by this pattern

Trace these in your risk file (ISO 14971) and usability engineering file (IEC 62366-1).

NotJustAnyMed.Tech Design System · Patient header · v1.0 · draft for review
Reference applications named in this system are fictional; all patient data shown is fabricated.