Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Best practices for accessibility

Updated on February 7, 2022

Accessible design helps users with disabilities access the full range of your application's features. By following best practices for accessibility, you ensure that your application meets the industry standards for all types of users.

The following list includes guidelines that can help you design an accessible application:

General guidelines

  • Review the Web Content Accessibility Guidelines (WCAG) Checklist, which is the primary source for meeting the industry standard for accessibility.
  • Run the accessibility inspector to spot check your application. For more information, see Inspecting accessibility.

Design guidelines

  • Use responsive layouts. Layouts and forms that have fixed window sizes might cause problems for users who need to resize their screens.
  • Avoid inline styles, which might override custom settings that help user better read a page.
  • Add labels to all fields, controls, cards, and images.
  • Notify users of dynamic changes by ensuring that the UI alerts users about the change of state visually and through Live ARIA.
  • Organize content on the screen and in the document object model linearly to accommodate screen readers.
    Tip: If your UI includes a large conditional section, consider making the transition explicit by putting the conditional content in multiple assignment steps.
  • When providing helper text, avoid referencing the color, shape, or visual location of a UI component.
    Tip: Write Click the Submit button rather than Click the blue button.
  • Do not force landscape or portrait mode in mobile apps.
  • Provide meaningful error messages. Avoid generic messages such as This entry is invalid.
  • Do not wrap text in images.
  • Use caution when introducing multiple icons. Ensure that the icons are properly labled and can receive focus from the keyboard. For more information, see Configuring actionable icon controls.
  • Avoid timed events, which require complex configuration to be compliant with accessibility guidelines.
  • Avoid key commands. Key commands can conflict with screen readers.
  • Check if the user can navigate your design with keyboard only.

Color use guidelines

  • Do not use color as the only indicator of a change of state. For example, if an error causes the field to display a red border, but does not produce any other indicators, the field is not accessible.
  • Use a 4.5:1 contrast ratio for text against the background color.
  • For meaningful icons, such as warning icon, use a 3:1 contrast ratio against the background color.
  • For form fields, use a 3:1 contrast ratio against the background color and the border.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us