Skip to content

Official government website An official website of the Federal Government of Nigeria

How you know
Federal Ministry of Communications, Innovation & Digital Economy Nigerian Design Standards

Radio

Lets people choose exactly one answer from a short list of options.

Updated

Live example

Radio
Controls
Property Control What it does
Default, active, disabled or error
Selected
Selects the option
The option, in a few words

Overview

Radios sit in a group, under a legend that asks the question, and people can choose only one. Use them for fewer than 7 options, so people can see them all.

Use radios for

  • Questions with exactly one answer
  • Fewer than 7 options
  • Yes or no questions

Don’t use radios for

  • More than one answer (use checkboxes)
  • 7 or more options (use a select)
  • A setting that changes straight away (use a toggle)

States

The circle’s states. Disabled is also available, but explain why an option isn’t available instead where you can.

Unselected

A 20px circle with a 1px border/strong outline.

Selected

action/primary/default border with a centred inner dot.

Active

2px border/dark around the control. Not the keyboard focus ring.

Error

A red border, always with the group’s error message.

Specifications

The properties of the radio. The same in HTML, WordPress and React.

Radio properties
Property Type Possible values Description
label string any text The option, in a few words. The whole label is clickable.
selected boolean
  • false default
  • true
Whether this option is chosen. Only one in a group.
name · value string any text Sent with the form. Radios in one group share a name.
disabled boolean
  • false default
  • true
Avoid where you can: explain why an option isn’t available instead.

In code, each option is an <input type="radio"> with a <label for>, so the whole label is clickable. Radios in a group share one name. Put the group in a <fieldset> with a <legend>; the hint and error ids go on the fieldset’s aria-describedby.

Tokens

Radio tokens and contrast
Part Token Contrast on the page
Circle 20px (size/icon/md) · radius/200 · surface/canvas —
Border border/strong, 1px 4.2:1
Selected dot action/primary/default 5.8:1
Active border/dark, 2px 14.3:1
Error status/error/surface border, with the group’s error message 4.9:1
Label Body/medium · text/primary 17.6:1
Spacing spacing/100 8px circle to label · spacing/150 12px between options · spacing/300 24px in a fieldset —

Use cases

Do

Have you contacted us before?

Select one option

Ask the question in the legend and stack the options, one per line.

Don’t

Don’t put an error on one option. The group gets one error message under the legend.

Layout

How radios are laid out.

One per line
Stack options vertically, never in columns.
Legend first
Then the hint or error, then the options.
12px between options
24px (spacing/300) inside a fieldset, 32px (spacing/400) between questions.
Whole label clickable
The label is part of the target, so it is easy to tap.
Fewer than 7 options
For 7 or more, use a select.

Copywriting

How to write the question, the options and the error.

Ask in the legend
Have you changed your name?
Keep options short
“Yes” and “No”, not full sentences.
Order them logically

Most common first, or a natural order like Yes, No.

Let everyone answer

Add “None of these” or “Prefer not to say” when it applies.

One error for the group

“Select if you have changed your name”.

Don’t preselect

Leave all options empty, so people make a real choice.

Examples

Radio copywriting examples
Write Don’t write Why
Yes · No Yes, I have · No, I haven’t Short.
Select if you have changed your name Please select an option Says what to do.
Have you changed your name? Name change status A clear question.
Prefer not to say N/A Plain words.
Text message SMS Plain words, no jargon.

Accessibility

Real radio inputs with labels, grouped in a fieldset with a legend.

Keyboard interaction for radios
Key What it does
Tab Enters the group on the selected radio (or the first). Tab again leaves the group.
↑ ↓ ← → Moves to the next radio and selects it.
Space Selects the focused radio.
  • Each radio has a <label for>, and the whole label is clickable (WCAG 1.3.1, 2.5.8).
  • The group is a fieldset with a legend; the hint and error are linked with aria-describedby (WCAG 1.3.1, 3.3.2).
  • Radios in a group share one name attribute, so arrow keys move between them (WCAG 2.1.1).
  • The border is 4.2:1 and the selected inner dot 5.9:1 (WCAG 1.4.11).
  • Active shows a 2px border/dark border, 14.3:1 (WCAG 2.4.7).

For developers

Copy the code for HTML, WordPress or React from the Code tab in Live example. The options are listed under Specifications.

For designers

Use Form/Radio from 01 Library – Foundations, inside Form/Radio group for a question. Set Selected, State and the Label. Don’t detach it.

References

Feedback

Report a problem with this page