This is a DRAFT resource that supports Working Drafts of WCAG 3. Content in this resource is not mature and should not be considered authoritative. It may be changed, replaced or removed at any time.
🔙 WCAG 3.0 (Silver) Guidelines (Clear words)
Clear words
Use clear words.
Summary
The Clear words guideline uses research-based strategies to improve the experience of individuals with cognitive and learning disabilities. Clear words help create more accessible content. Writing and editing with clear words includes the following guidance:
- use common words;
- define uncommon words;
- use simple tense;
- use literal language;
- avoid double negatives;
- avoid nested clauses; and
- use appropriate diacritical marks (such as è, ñ, ç).
Why
- Clear words benefit individuals who live with cognitive and learning disabilities, language impairments, memory impairments, and autism.
- People with language impairments often have a reduced vocabulary and learning new terms is a very slow difficult process. For other groups, such as people living with dementia, learning new terms is not realistic or possible. Using common words that they already know will make the content understandable and usable.
- Simple tense, literal language, and active voice make it clear what needs to be done for individuals who struggle to interpret implicit information.
- Clear words improves everyone's reading success and allows for a broader audience.
Who it helps
There are many types of disabilities that can make it harder to read, including a large range of cognitive and learning disabilities, mental health conditions, aging-related conditions, print disabilities, and cognitive impacts of some chronic or other health conditions. It also helps people who are non-native language speakers.
Not all individuals with cognitive and learning disabilities have the same needs. Difficulties with reading vary by disability but also by individual. It’s important not to make assumptions. Many people with disabilities can understand specialized or complex information, but they may benefit from the same principles of clear words.
Clear words generally help everyone, especially people who may have difficulty reading due to disability. Reading may also be more difficult when tired, distracted, under stress, with low-literacy, when working outside one’s first language (such as with some sign language users), or when vision is impaired.
How
- Write clearly and edit your content.
- Follow principles for plain language.
- Use a professional editor when possible.
Planning responsibilities
- Prior to finalizing the project budget, consider possible costs associated with developing accessible content, written in clear language.
- During project planning, coordinate efforts with the project team to organize and schedule the approach to creating content written in clear words . Considerations to discuss:
- If possible, secure content authors or editors with experience writing in plain language
- Direct content authors to the clear words guideline
- Provide training on how to develop content that uses plain language principles. Determine if you will create a style guide to clearly communicate the unique needs of your content. Plan and schedule iterative plain language quality assurance checks throughout the project cycle. Schedule time for cycles of editing.
- If your content requires legal review, bring in legal experts early so they agree with using plain language.
- If your content uses a lot of technical terms, idioms, jargon, metaphors or sarcasm, plan the time to write clear words summaries.
- You may need a glossary section to define terms. This will need to be designed and coded.
Tips for collaboration
- Work with the design team to include visually and semantically distinct heading structure (see Headings) and ability to display definitions of terms and summaries.
- Decide if you will do studies to gather end user feedback that includes people with disabilities. If so, develop a schedule and process for obtaining and integrating the feedback.
- Decide which approach will be used to evaluate clear words. For example, one or more of the following approaches could be used:
- Use an professional editor
- If a style guide exists, use this to evaluate clear language
- Use the method Use Clear Words - written, not coded yet
Design responsibilities
- Ensure that you...
- style the definitions of complex or uncommon words so they are visually prominent;
- design the glossary and interactions;
- design visually distinct plain language summaries before blocks of text, if needed;
- make it easy to find definitions and summaries; and
- use in-line definitions so the user can get to the definition in one click and return to their place in one click. Usually this is done with a modal (popup) with a close button, which can be an X is upper right.
Designer Tips
See the W3C WAI Perceptions Video on Understandable Content.
Technical responsibilities
Ensure that inline definitions are accessible by ensuring the definitions:
- are keyboard accessible;
- remain open once activated (either by keyboard or hover) until the user closes them [1];
- are visually distinct from a link;
- are designed with one click to the definition and one click return; and
- are displayed in an accessible modal dialog [2].
Because of hover limitations on mobile, hover states should only act as confirmation that an element is actionable. See BBC Mobile Accessibility Guidelines: Actionable Elements.
When inline definitions are displayed in a modal, all the accessibility requirements of a modal should be included, such as:
- disable the background text (use a modal display);
- ensure that background text is covered or blurred so people aren't confused between foreground and background text; and
- ensure that keyboard focus remains in the modal until it is closed.
Technical tips
Example of Clear Words
Before: The Dietary Guidelines for Americans recommends a half hour or more of moderate physical activity on most days, preferably every day. The activity can include brisk walking, calisthenics, home care, gardening, moderate sports exercise, and dancing.
After: Do at least 30 minutes of exercise, like brisk walking, most days of the week.
- W3C Web Accessibility Perspectives: Understandable Content - video
- Print disabilities Wikipedia article
- Publications Office of the EU: How to write clearly - International resources for plain language
- Federal Plain Language Guidelines - US government official website
- Modal Dialog Example | WAI-ARIA Authoring Practices 1.2
- W3C Web Accessibility Tutorials: User Notifications
- BBC Mobile Accessibility Guidelines: Actionable Elements