Writing for user interfaces
Aim to minimise by being as clear as possible and using the same language as your users. This helps:
- reduce the amount of time you spend dealing with mistakes
- make your service inclusive for people who struggle with reading or have limited English
- make your service accessible
Even specialist users prefer clear language. No one likes having their time wasted, .
Itâs especially important to choose an intuitive name for your service. If your title reflects your usersâ language, theyâll be able to find your service and understand what it does.
Donât follow strict grammar conventions if it makes things clearer not to.
Think about alternatives before you add more words
On the internet . Even more so when theyâre using a transactional service.
So start with less. If youâre creating a form, start with some simple questions and only add help text if user research shows that you need it.
Design your service to take account of the fact that lots of people wonât read the content in detail. For example, rather than putting a long list of eligibility conditions on the start page.
If you find yourself having to explain how the user interface works, thatâs a sign something has gone wrong. Fix the interface so it doesnât need explaining.
Keep copy short and direct
Break up copy into short sentences. One idea per sentence.
Space is at a premium with user interfaces. So put the important words first and drop any unnecessary words.
For example, if youâre writing help text thereâs usually no need to say âThis is the total costâ. Just say âTotal costâ. If youâre writing an error message, donât say âYou have entered the wrong passwordâ. Say âWrong passwordâ.
You donât usually need the word ânowâ. For example, just say âapplyâ rather than âapply nowâ (unless youâre giving the user two options: apply now or apply later).
Tone
Be approachable and helpful, but not overly familiar. Remember that itâs government âspeakingâ.
Say âsorryâ if something serious has gone wrong - for example, the service has stopped working completely. âSorry, there is a technical problem. Please try again in a few moments.â
Thereâs no need to say âsorryâ in validation error messages.
Thereâs usually no need to say âpleaseâ or âplease noteâ.
Thereâs usually no need to say thank you. For example, itâs fine to say âApplication completeâ rather than âThank you for your applicationâ.
Avoid things like humorous error messages. People often use government services for serious things or when under stress.
If people donât notice your copy, youâre probably doing it right. .
Donât exclude anyone
Donât rely on shape, size, colour or location alone to communicate information, because not all users will share that frame of reference. For example, donât say things like:
- âclick the green buttonâ
- âuse the menu on the left of the pageâ
- âfind more information in the square boxâ
Break up long pages with headings. Itâs easier to scan and read. Headings should describe the purpose of the text that follows - they shouldnât be part of the text.
Screen reader users often read out lists of links in isolation, so make the purpose of the link clear from the link text alone. For example, âclick hereâ is not accessible link text.
Sometimes you need to shorten link text to avoid lots of duplication. If you do that, make sure links are still accessible to screen readers. For example, by adding hidden text to the âchangeâ links on check your answers pages.
Style
Follow the ÒÁÈËֱȄ style guide on how to write times and dates, spelling, punctuation, acronyms and other conventions.
Headings and <title>
Itâs fine to have headings as questions. In fact, it can help to remove duplication.
But make sure every text box, set of radio buttons or other input field still has a question directly associated with it in the html, so it makes sense to screen readers. For example, by using a visually hidden <legend> or <label>.
Each page should have a single <h1>. The <h1> should describe what the page does.
The <title> should be based on the <h1>, and follow this format:
Where do you live? - Register to vote - ÒÁÈËֱȄ
Pronouns (we, you, me, my)
Forms are like a conversation between the service and the user.
If itâs the service âspeakingâ, the user is âyouâ or âyourâ and the service is âweâ, âusâ, âourâ and so on.
If itâs the user âspeakingâ, use âIâ, âmeâ or âmyâ.
This applies to all microcopy, including headings, input labels and link text.
For example, the Register to vote service asks users âWhat is your National Insurance number?â. If the user doesnât know their number, they can click a link labelled âI donât know my National Insurance numberâ.

Use âtheyâ instead of âhe or sheâ or âhe/sheâ. Itâs simpler, and works better for people who donât identify as male or female.
Capitalisation and punctuation
Use sentence case everywhere, except for proper nouns.
Headings and input field labels are sentence case, but not punctuated. Write other copy in full sentences, with a full stop at the end.
Contractions, abbreviations and acronyms
Donât use âieâ. Use âfor exampleâ instead of âegâ.
Use simple contractions like âyouâreâ and âweâllâ.
Avoid:
- shouldâve, couldâve, wouldâve, theyâve - these can be hard to read
- negative contractions like âcanâtâ and âdonâtâ - some users find them harder to read, or misread them as the opposite of what they say
Include any relevant acronyms on your ÒÁÈËֱȄ start page for SEO purposes, but try to avoid using them inside the transaction.
And if you do use them, spell them out in full on each page. Donât rely on people remembering them across different pages.
URLs
Make sure your URLs are clear and readable. This will help users understand where they are in your service.
Donât include personal information (like a userâs name or date of birth) in the <title> field of a URL - you donât want it to show up in your site analytics.
Legal content
All language should be as simple to understand as possible, including privacy policies and declarations. Explaining usersâ rights and obligations clearly is good legal practice as well as being good for usability.
Further reading
Read these blogs to find out more about writing for user interfaces:
Updates to this page
-
Added guidance about using contractions and abbreviations.
-
Added guidance on designing URLs.
-
Guidance first published