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: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
HDJ2123FA 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.
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: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.