Tips for accessible language

Prev Next

Accessible language ensures that all users, including people with disabilities, can understand and engage with your content. Writing in an inclusive and clear manner improves readability for everyone, especially those using screen readers, cognitive support tools, or translation services.


Key principles of accessible language

Use clear and simple language

  • Write in plain language to make content easy to understand.

  • Use short sentences (preferably under 20 words).

  • Avoid jargon, technical terms, or complex words unless necessary. If needed, provide a brief explanation.

Example:
Utilize the configuration panel to implement the requisite modifications.
Use the settings panel to make the required changes.


Be concise and direct

  • Remove unnecessary words and keep instructions straightforward.

  • Use active voice instead of passive voice for clarity.

Example:
The article can be found by clicking the search icon.
Click the search icon to find the article.


Use inclusive and respectful language

  • Avoid terms that exclude or marginalize any group.

  • Use gender-neutral language instead of assuming gender.

  • Use person-first language.

Example:
The administrator should enter his credentials.
The administrator should enter their credentials.


Provide alternative text (Alt text) for images

  • Describe images concisely but informatively for screen reader users.

  • Focus on the purpose of the image, not just its appearance.

Example:
Image of a chart
Bar chart showing customer satisfaction trends from 2022 to 2024.


Ensure readability and structure

  • Use headings, bullet points, and white space to improve scan-ability.

  • Break large paragraphs into smaller, digestible sections.

  • Avoid excessive use of bold, italics, or underlining, as they can be difficult for some users to read.


Avoid ambiguous words and phrases

  • Be precise to help users understand instructions easily.

  • Avoid directional words (e.g., “click the button on the right”) instead, describe the function.

Example:
Click the blue button on the right to submit.
Click the Submit button to complete your action.