WP A11y Docs update April 2026

New and updated documentation: about alternative text for images, headings and links plus an introduction to WCAG. Featured content: Styling links.

Work in progress: documentation about how to test for accessibility, update of the info about the accessibility-ready tag in the themes handbook and figure out a section “Can I use”.

New and updated content, added in April 2026:

• Getting started:
  • Introduction to WCAG. Annelies Verhelst (@anneliesjenl ) wrote an explanation about what the Web Content Accessibility Guidelines are and how they relate to WordPress.
• Content and images:
  • Alternative text for images in the content.
  • Using headings in the content.
  • Write meaningful link text.
  • Images as links.
  • Link destinations.
• Design and user experience:
  • Styling links.
• Frontend code:
  • Alternative text for images, SVGs and icons in development.
  • Image animation and accessibility.
  • Heading structure in theme development.

Work in progress

At the moment we are working on extending and updating the docs about how to web accessibility.

In May ’26 we want to update the information in the Themes handbook about the accessibility-ready tag. We updated the guidelines and the current info on Themes handbook about accessibility is outdated.

We are also discussing if and how to set up a “Can I Use” section for core blocks. With the status per block about its accessibility. All input is appreciated, we want to set something up that is not a ton of work, but is findable and informative for users. This may be a good topic to work on at WordCamp Europe ’26.

All feedback on the documentation is very much welcome.

#accessibility-ready, #wp-a11y-docs