Writing for Accessibility

BETA
Decorative background image
Foundations / Writing and Wording / UX Writing / UX Writing Guidelines / Writing for Accessibility

Accessibility in UX Writing

Accessibility refers to the possibility for everyone, including and especially people with disabilities, to interact with and successfully use the product.

Accessible UX writing ensures our products are usable by everyone, including people with disabilities.

Here are key reasons why accessibility is important in UX writing:

Visible vs. Hidden Text

For UX writers, writing accessible text means thinking about text on two levels.

Example of hidden and visible tooltips for feedback icons: Thumbs-up has both invisible and visible labels "Positive Feedback". Thumbs-down has corresponding hidden and visible labels "Negative Feedback".

Example: Hidden and visible label for an icon button

Accessibility Labels and ARIA Text

Designers add accessibility annotations to design files. These are nonvisible labels or descriptions associated with an element to provide users of assistive technologies with a label for the element. Your role is to write the text that becomes the ARIA (Accessible Rich Internet Applications) attribute in the code: writing an annotation means writing the text that will become an ARIA label.

Examples:

In most circumstances, visible UI text is preferred as an accessible name, as it simplifies maintenance and reduces language translation requirements. But if a UI element has no visible text or not enough context in the text to guide users of assistive technologies, UA developers need to name the element with a string that is not visually rendered to ensure that screen readers describe the element as accurately and helpfully as possible.

What is ARIA?

An ARIA label is an HTML attribute used to provide an invisible, descriptive text label for interactive elements (like buttons, links, or landmarks) that lack readable text, such as icon-only buttons. It is a short, standalone accessible name announced by the screen reader in place of any visible text labels and conveys the purpose of the element by the screen reader. It ensures screen readers can announce a meaningful name, improving accessibility for users with disabilities.

Which elements need labels?

How Users Work with Assistive Technologies

Screen readers don't simply read words on screen — they announce a comprehensive description including the element's label, role, and current state. For example, a button announces as “Submit, button” while a checkbox might announce as “Remember me, checkbox, not checked.”

Key user patterns

Tool dependencies

Different screen readers and assistive technologies may interpret content slightly differently, so consistent, semantic markup and clear language are crucial for reliable experiences across tools.

For more information on accessibility tools, see Check Tools and Simulation Tools.

Key Guidelines and Best Practices

This section outlines the essential standards for creating accessible user interface text. The following guidelines and best practices are based on the Web Content Accessibility Guidelines (WCAG).

These guidelines focus specifically on the textual elements of a digital interface, ensuring that content is perceivable, operable, and understandable for all users, including those using assistive technologies.

By following these standards, you ensure that screen readers can effectively convey the interface's purpose and that all users can interact with the system without confusion.

Link text must clearly state the destination. Don't make people guess.

Do

Download the 2024 Sales Report (PDF)

Being specific helps people know what will happen when they click.

Don't

Click here to see the report

Using non-descriptive text creates barriers for users with cognitive or visual disabilities.

Unique page titles

Every web page must have titles that describe the topic or purpose. This is the first thing a screen reader says when the page opens.

Do

Profile Settings

Unique names help people who have many tabs open.

Don't

App Home Page

Using non-descriptive text creates barriers for users with cognitive or visual disabilities.

Descriptive and clear section headers

Headers describe the content that follows. They act like a map for people scanning the page.

Do

Your Shipping Address

Don't

Section 2.1

Forms

Every input box needs a permanent, visible label. Don't use the text inside the box (placeholder) to replace a real label.

Do

Label: Email Address

Placeholder: name@example.com

Labels must remain visible at all times to assist users with short-term memory challenges.

Don't

Placeholder: Email Address (no real label)

Using non-descriptive text creates barriers for users with cognitive or visual disabilities.

Button labels

Button text should tell the user exactly what will happen next.

Do

Create Account

"Create Account'" is much clearer than ‘"OK" for a profile creation.

Don't

OK

Using non-descriptive text creates barriers for users with cognitive or visual disabilities.

Instructions

Avoid directional terms

Avoid instructions that rely on color, shape, or where something is on the screen.

Do

Select "Next" to continue.

Don't

“Click the green button on the right.

People who are visually impaired cannot see colours and people with cognitive disabilities might have difficulties with directions.

Mark links that open in new tabs

Always tell the user if a link is going to open in a new tab or window.

Do

Read Instructions (opens in a new tab)

Unexpected new windows can be confusing for screen reader users.

Don't

Read instructions.