A help message below the membership code of a form
Image description: A website titled, "Confirm your membership." There are 2 text fields below. The name is filled in with, "Pink Nugget III." The membership code is highlighted and has a help message that says, "Found on page 2 of your welcome packet."

This page is in progress -

If you would like to contribute or make a case to prioritize this page, please fill out the form below.

Why This is Important

Contextual help, which provides support for what the user is currently interacting with, is accessible to people with cognitive, reading, and learning disabilities.

Many websites and apps have a help center that you can read. Contextual help is slightly different in that it provides help that’s specific to what you’re interacting with in context (for example, it could explain how to fill out a text input). This is accessible to people with cognitive, reading, and learning disabilities as well as people in situations that might elevate stress and confusion.

This references WCAG criterion 3.3.5 Context-Sensitive Help (Level AAA).

How to Implement This

There are a few different ways to approach contextual help. The techniques include: inline instructions, tooltips, embedded help center, and embedded chat.

Keep in mind that tooltips may not be the best option. According to Adam Silver, tooltips are difficult to interact with and could potentially run into issues on different screen sizes. Additionally, revealing content on hover isn’t a very accessible interaction.

Inline Instructions

Inline instructions appear next to the input. They are most effective if they’re short, clear, and concise.

For example, these inline instructions help explain the system requirements for creating a new password:

Password text inputs with inline instructions below.
Image description: 2 text inputs. The one labeled “New Password” has inline help that says, “Must be at least 8 characters.” For “Confirm Password,” the help says, “Passwords must match.”


If the instructions need to be longer in order to be supportive, the inline instruction can be a link that opens a modal dialog or new page with the full instructions. For example:

A text input of a Group ID with an inline link that opens to a modal dialog.
Image description: A text input labeled “Group ID.” Below, there’s an inline link that says, “Where can I find my Group ID?” which opens a modal dialog that explains, “Look on the back of your membership card for your Group ID. It is a 6 digit code.” Below is an illustration of the card with the ID circled in red.

Embedded Help Center

The help center, also often known as the help guide or support, is a full collection of all the support documentation available.

Here are some examples of help centers:


The help center can be embedded on the page and made more contextual by linking to specific pages that are relevant to what is on the page.

Google products are a great example of contextual embedded help. They surface specific help articles about the product that you are currently working on in the help menu, for example, for google slides:


Google's embedded help center for google slides.
Image description: A screenshot of the help menu, which is hovered over the “Slides Help” menu item. This opens to a help menu that shows a list of popular help resources that are related to slides.

Interesting Further Reading

How to Test This

This requires manual testing. Review the website/app for the presence of any context-sensitive help and support.

Credits

No credits yet. But this could be you!
No items found.

Contribute and Give Feedback

If you would like to provide feedback or contribute content on this resource, please fill out the form below.

Thank you, your submission has been received!
Oops! Something went wrong while submitting the form. Please check your internet connection and try again.

If you continue to encounter issues, please reach out to alexyingchen(at)gmail.com.