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:
- Would someone say it out loud? "Raised" passes. "Elevated" does not.
- 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.
- 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.
- Is it the same word every time? One clinical term maps to one plain replacement across the product.
| Write | Not |
|---|---|
| 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.
| Avoid | Use instead |
|---|---|
| water pill, for a diuretic | the medicine's name, and what it does |
| sugar, for glucose in a result | blood sugar once, then the measure's name |
| good cholesterol, bad cholesterol | the named fraction, and what a higher figure means |
| passed away | died |
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.
showBoth | Behaviour |
|---|---|
always | Both forms every time, so a reader can match the screen to their paperwork |
first-use | Both forms the first time on a screen, then the plain wording alone. Express it with Term's once prop |
plain-only | The 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.