Skip to content
opsinjs
Edit this page

Reference

Plain English A to Z

The clinical words a reader meets, the plain words to use instead, and how Term shows them in your product.

Each entry maps a clinical term to the plain wording a writer uses instead. Every definition is written from scratch for opsinjs. Nothing is copied from the NHS A to Z, any other Crown-copyright source, a dictionary or a manufacturer's leaflet.

Choosing a plain word

A replacement passes four tests, in order:

  1. Would someone say it out loud? "Raised" passes. "Elevated" does not.
  2. Does it lose anything the reader needs? "Water pill" is plainer than "diuretic" and wrong, because the reader will not recognise it on the box. When plainness costs accuracy, use both words.
  3. Will they meet the clinical term elsewhere? If it is on their prescription, letter, portal or monitor, give the clinical term and the explanation once, then the plain form.
  4. Is it the same word every time? One clinical term maps to one plain replacement across the product.
WriteNot
Your blood pressure was 148 over 92. Your GP might call the top number "systolic".Your systolic BP was 148 mmHg and your diastolic was 92 mmHg.
Long-term (lasting months or years)Chronic
A steroid inhaler (sometimes called a "preventer")An inhaler

Some plain words make things worse.

AvoidUse instead
water pill, for a diureticthe medicine's name, and what it does
sugar, for glucose in a resultblood sugar once, then the measure's name
good cholesterol, bad cholesterolthe named fraction, and what a higher figure means
passed awaydied

Term in your product

Term shows a clinical word with its everyday meaning attached. It ships with an empty glossary. Your product passes its own entries to TermGlossaryProvider once, and each <Term id> looks one up. An id with no entry renders unmarked and warns in development.

import { Term, TermGlossaryProvider } from "@/components/ui/term"

<TermGlossaryProvider glossary={GLOSSARY}>
  <p>
    An <Term id="acute" /> problem started suddenly.
  </p>
</TermGlossaryProvider>

Each entry's showBoth says when the clinical term appears.

showBothBehaviour
alwaysBoth forms every time, so a reader can match the screen to their paperwork
first-useBoth forms the first time on a screen, then the plain wording alone. Express it with Term's once prop
plain-onlyThe clinical term never reaches the reader. The entry tells authors what to write instead

A definition says what a word is, in one sentence. It is never what to do, what the word means for this reader, or a reassurance. Review your glossary as clinical content, not as microcopy.

Term shows the clinical word with the plain wording attached, which is the reverse of policy.rule in tokens/glossary.json. That conflict is still open.

The A to Z

The list is authored in tokens/glossary.json, which also holds a banned list of words such as normal, elevated and don't worry, each with a replacement. Treat a change to a plain wording as a breaking change to copy, and record it in the changelog.

36 of 36 entries

acute
sudden, or short-lasting
Show both when: first-use
Often misread as 'severe'. It describes how quickly something started, not how bad it is.
adherence
taking a medicine the way it was prescribed
Show both when: plain-only
'Compliance' frames the reader as obedient or not; 'adherence' is better but still clinical. Write what actually happened instead.
adverse effect
an unwanted effect of a medicine
Show both when: first-use
'Adverse' is not everyday English. 'Side effect' is understood, but it can make a serious effect sound minor, so say what the effect is.
benign
not cancer
Show both when: always
This word appears on reports and is one of the few whose plain meaning is genuinely reassuring, so the reader should be able to match the two.
biomarker
something measurable in your body that says something about your health
Show both when: first-use
Common in product copy, almost never understood outside research.
blood pressure
the pressure of blood pushing against the walls of your arteries, written as two numbers
Show both when: first-use
The words are familiar but the two-number format is not. Always explain which number is which where both are shown.
BMI
a number worked out from your height and weight
Show both when: always
The abbreviation is widespread and the calculation is not. Anywhere BMI is shown, say that it does not distinguish muscle from fat and is a poor guide for some people.
bradycardia
a slower than usual heart rate
Show both when: first-use
Appears in device output. Also note that a slow resting heart rate is expected in many fit people.
cholesterol
a fatty substance carried in your blood
Show both when: first-use
Widely known as a word, widely misunderstood as a single number. Most reports give several.
chronic
long-lasting, or ongoing
Show both when: first-use
Often heard as 'severe'. It describes duration.
contraindication
a reason this treatment is not safe for you
Show both when: plain-only
A word with no everyday equivalent that readers guess at. Never show it.
diastolic
the pressure between heartbeats, which is the lower of the two blood pressure numbers
Show both when: always
The reader's own record shows the clinical word, so both are needed to match them up.
eGFR
an estimate of how well your kidneys are filtering
Show both when: always
Appears on results with no explanation. The word 'estimated' matters and should never be dropped.
false positive
a result that says something was found when it was not there
Show both when: first-use
Essential for interpreting any screening result honestly, and impossible to explain after the fact if the first screen did not mention it.
fasting
not eating or drinking anything except water for a set time before a test
Show both when: first-use
Readers frequently assume water is included. Say the time and say that water is allowed.
HbA1c
your average blood sugar over about the last three months
Show both when: always
One of the most common results a consumer app displays and one of the least understood. Also flag that it is reported in two different units worldwide.
HDL
one of the types of cholesterol measured in a blood test
Show both when: always
Frequently described to readers as 'good cholesterol'. Avoid that shorthand: it invites the reader to treat one number as a verdict.
hypertension
blood pressure that stays higher than the usual range
Show both when: first-use
Frequently confused with 'tension' in the sense of stress.
hypoglycaemia
blood sugar that has dropped below the range you were given
Show both when: always
Time-critical. The reader may already know it as 'a hypo', and both forms must be recognisable.
in range
inside the range this test uses for comparison
Show both when: plain-only
The replacement for 'normal'. Always name whose range it is: a laboratory's range, a device maker's range, or a range a clinician set for this person.
LDL
one of the types of cholesterol measured in a blood test
Show both when: always
Usually captioned 'bad cholesterol'. Same objection as HDL: it turns one number into a moral judgement.
malignant
cancer
Show both when: always
Never soften this and never show it without a route to a person. See /docs/health/emergency-and-escalation.
mg/dL
milligrams per decilitre, which is a unit used for blood test results
Show both when: always
See mmol/L. Converting between the two is a correctness surface, not a display preference.
mmol/L
millimoles per litre, which is a unit used for blood test results
Show both when: always
The same measurement is reported in mmol/L in some countries and mg/dL in others, and the numbers are not close. Never show a value without its unit.
oedema
swelling caused by fluid building up
Show both when: first-use
Spelled two ways depending on country; the plain wording avoids the problem entirely.
out of range
outside the range this test uses for comparison
Show both when: plain-only
The replacement for 'abnormal'. It states a fact about a comparison and leaves the interpretation to whoever is entitled to make it.
prognosis
what is likely to happen next
Show both when: plain-only
A word no component should ever need. If a product is showing a prognosis, a clinician wrote it.
reference range
the range a test result is compared against
Show both when: always
The most important term in this glossary. A reference range is a comparison, not a target, and it belongs to a laboratory or a device rather than to the reader. Always name whose range it is and never call it a normal range.
remission
a period when the signs of an illness have reduced or gone
Show both when: first-use
Often heard as 'cured'. The plain wording keeps the distinction.
resting heart rate
how many times your heart beats a minute when you are at rest
Show both when: first-use
Understood as words but frequently confused with the heart rate shown during activity. Say when it was measured.
screening
a test offered to people with no symptoms, to look for a possible problem early
Show both when: first-use
Readers commonly assume a screening test is diagnostic. It is not, and the difference determines what the result means.
SpO2
an estimate of how much oxygen your blood is carrying
Show both when: always
Shown by consumer devices as a bare percentage. The word 'estimate' is not optional: the measurement is affected by movement, cold hands and skin tone, and the product must say so.
systolic
the pressure while your heart beats, which is the higher of the two blood pressure numbers
Show both when: always
See diastolic.
tachycardia
a faster than usual heart rate
Show both when: first-use
Appears in device output with no explanation and reliably alarms people.
titration
changing a dose in small steps until it is right for you
Show both when: plain-only
No everyday equivalent; the plain wording is complete on its own.
triglycerides
a type of fat measured in a blood test
Show both when: always
Appears on the same report as cholesterol and is routinely mistaken for it.