Learn about accessibility best practices for customizations.
To build a customization that everyone can use, it requires understanding and following specific accessibility standards. The guidelines on this page target the Web Content Accessibility Guidelines (WCAG) 2.2 (Level AA) as the foundation for web and digital accessibility. In addition to these best practices, we recommend that you familiarize yourself with the WCAG principles of accessibility.
You are responsible for ongoing compliance with accessibility regulations in the countries where you operate.
Design guidelines
- Use personas that include people with visual, hearing, motor, or cognitive disabilities.
- Ensure text has sufficient color contrast (at least 4.5:1 for normal text).
- Allow users to resize text up to 200% without loss of content or functionality.
- Make all features accessible through keyboard.
- Keep the interface structure predictable and easy to understand.
Technical guidelines
- Use semantic HTML (
<button>,<nav>,<main>, etc.). - Ensure ARIA roles and properties are properly implemented.
- Support screen readers (test with NVDA, JAWS, or VoiceOver).
- Provide text alternatives for all non-text content (for example, images, videos).
- Avoid flashing or blinking elements that may trigger seizures.
Content guidelines
- Use plain language and short sentences.
- Use descriptive links (for example, "Read about our services" instead of "Click here").
- Provide transcripts or captions for audio or video content.