BETA This playbook is in BETA, we think it’s good enough to be useful right now, but there are gaps that need filling – your feedback will help us to improve it.

Overview

Use hint for help that’s relevant to the majority of users, like how their information will be used, or where to find it.

When not to use this pattern

Do not use long paragraphs and lists in hint text. Screen readers read out the entire text when users interact with the form element. This could frustrate users if the text is long.

How it works

For question explanations or to explain why we are asking this question:

We’ll only use your email to send you a receipt

 
For section explanations or summaries:

Your details

This is an example of guidance text at the start of a section.

 
To provide a user with an example input use the placeholder input field setting:

Things to remember

Avoid links

Do not include links within hint text. While screen readers will read out the link text when describing the field, they will not tell users that the text is a link.

Last reviewed: July 6, 2023 by James

Next review due: January 6, 2024

Back to top