Skip to main content
How to choose components

What a component means

What each component means to users before they read it

A component means something before anyone reads the words in it. When the component and the words agree, users understand straight away. Put reassuring words in warning text, and users still look for the risk.

These meanings come from what we have seen in research and in services. If your research shows something different, tell us.

Asking the user to act

Use these when the user needs to stop, fix something, or act before it is too late.

Component What it means to the user
Warning text "There is a risk I need to act on"
Error summary and error message "Something is wrong and I need to fix it"
Interruption page "I need to read this before I go on"
Manage a session timeout "My session is about to end"
  • Example: warning text

    Example:
    Warning Your payments could stop if you do not send your documents by 15 June.

    A user thinks: “There's a risk here I need to act on.”

These work best when they are rare. Users who see them often start to skim past them.

Telling the user something has changed

Use these for something the user was not expecting but needs to know now, such as a decision, a deadline or a service problem. If the user was waiting to hear, use a component that answers their question.

Component What it means to the user
Notification banner (important) "Something has changed that affects me"
Service unavailable and problem pages "I cannot use the service right now"
  • Example: important banner

    Example:

    Important

    A decision has been made on this claim.

    A user thinks: “Something’s changed that affects me.”

These work when something has really changed. Used for things that have not, they teach users to ignore them.

Answering the user's question

Use these to answer a question the user already has. Users trust the answer and stop looking, so these work when the answer is true for this user at this point.

Component What it means to the user The question it answers
Notification banner (success) "What I just did worked" "Did it work?"
Panel "I have finished this task" "Am I done?"
Quick reference "This is who or what I am acting on" "Who am I acting on?"
Check a service is suitable "This tells me whether it applies to me, and why" "Does this apply to me?"
Tag "This is where it is up to" "Where is this now?"
Timeline "This is what happened, in order" "What happened?"
Task list "This is what I need to do, and how far I have got" "How far have I got?"
  • Example: panel

    Example:

    Application complete

    Your reference number
    HDJ2123F

    A user thinks: “That’s it, I’m done.”

Some of these draw much more attention than others. Users notice a panel before anything else on the page, and can skim past a tag. See how much attention it draws.

Asking the user to commit

Use these when the task is a commitment. Using one tells the user they are agreeing to something.

Component What it means to the user
Make a declaration "I am confirming this is true"
Confirm understanding (proposed) "I am confirming I understand what will happen"
  • Example: make a declaration

    Example:

    By sending this, you confirm the information you have given is correct and complete.

    Accept and send

    A user thinks: “If I carry on, I’m saying this is true.”

A declaration and confirming understanding do different jobs. Keeping them separate means users know which one they are agreeing to.

Content the user can skip

Use these for content some users can safely ignore. They tell users that what is inside is optional.

Component What it means to the user
Details "I can open this if I need it"
Accordion "I only need the sections that apply to me"
Tabs "I only need the tab that applies to me"
  • Example: details

    Example:
    If you have never had a National Insurance number
    You can still apply. Tell us your date of birth and full address instead.

    A user thinks: “I can skip this if it does not apply to me.”

These work when a user who never opens them can still finish the task.

Giving the user context

Use these for content the user should think about but not act on. The component does not show why the content matters, so the words do that job.

Component What it means to the user
Inset text "That is useful to know"
  • Example: inset text

    Example:
    It usually takes up to 6 weeks to get a decision.

    A user thinks: “That’s useful to know. There’s nothing I need to do.”

Inset text is easy to read past. If the user needs to act, use a component that asks the user to act.

Asking the user for something

Use these when the task needs something from the user, such as an answer, a choice, a document or an address. Hint text sits inside a question. Use it for help most users need to answer.

Component What it means to the user
Hint text "This helps me answer the question"
Radios "I need to choose one of these"
File upload "I need to send this document"
Find an address "I need to give my address"
  • Example: radios with hint text

    Example:
    Do you live with a partner?
    This includes someone you are married to, in a civil partnership with, or live with as a couple.

    A user thinks: “I need to choose one of these, and the hint tells me what counts.”

These work when the task asks the user for something. On a page where the user is only reviewing evidence, radios suggest there is a choice to make when there is not.

Meaning that comes from the parts

Some components mean what their heading, labels, values and actions say together. One wrong label can change what the whole thing means.

For example, a timeline headed "Address changes" that lists a claim, an identity check and a decision. Each row is accurate, but the heading makes the whole timeline untrue.

Component Parts that carry the meaning
Summary list Heading, row labels, values and row actions
Summary card Card title, card actions, and the rows inside
Table Caption, column headers and cells
Check answers Section headings, row labels, answers and change links
Contact a service Heading, contact methods and opening times
  • Example: summary list

    Example:
    Date of birth
    12 March 1958
    Relationship
    Partner

    A user thinks: “The labels tell me what this is.”

Read each heading and label against what sits under it, and check each action does what its link text says.

Something missing or does not belong here?

Tell us what you have found when choosing components, or anything this guidance does not cover. Let us know.