WP A11y Docs update March 2026

This update informs you about:

• new and updated documentation on wpaccessibility.org;
• work in progress.

New and updated documentation on wpaccessibility.org

• Quick wins to improve the accessibilityAccessibility Accessibility (commonly shortened to a11y) refers to the design of products, devices, services, or environments for people with disabilities. The concept of accessible design ensures both “direct access” (i.e. unassisted) and “indirect access” meaning compatibility with a person’s assistive technology (for example, computer screen readers). (https://en.wikipedia.org/wiki/Accessibility) of your website.
• The Reading guide, vistors now can find content by role or expertise instead of by topic only.
• A Disclaimer, in short: This documentation is intended to help the WordPress community understand and implement accessible practices. It is not a replacement for the official Web Content Accessibility Guidelines.

Focus management

• Frontend code: Handling visual and keyboard focus, with subpages addressing:
  • Tabindex and tab order
  • Visual focus
  • Trapping focus
  • Restore focus
  • Autofocus
  • On input, focus and hover
  • Keyboard trap
• Webforms: No positive tabindex.
• Design and user experience: Styling focus and hover states of interactive HTML elements.

Training

Start with accessibility: How to get training to learn web accessibility, with subpages addressing:

• Online training. An overview of training, meetups and conferences to learn accessibility.
• Books. Recommended books about web accessibility.
• Online events. An overview of training, meetups and conferences to learn accessibility.
• Knowledge resources. Knowledge resources and newsletters on web accessibility.
• Education & Discussion Groups. How to find peer support and meet people to learn accessibility.

Current handbook

We will wait with transferring the current Accessibility Team Handbook to GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged by the repository owner. https://github.com/ until later, we need to explain and discuss this in more detail with the MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. team. Maybe WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Europe will be a good opportunity for this.

Work in progress

We are discussing if and how to set up a “Can I Use” section for coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. blocks (GitHub issue 294). With the status per core blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. about its accessibility. All input is appreciated.

Documentation we are working on to improve at the moment:

• Alt text for images in the content and in theme development.
• Headings in the content and in theme development.
• Introduction to WCAGWCAG WCAG is an acronym for Web Content Accessibility Guidelines. These guidelines are helping make sure the internet is accessible to all people no matter how they would need to access the internet (screen-reader, keyboard only, etc) https://www.w3.org/TR/WCAG21/..
• Accessibility for your business.
• Legislation.

All feedback on the documentation is very much welcome.

#wp-a11y-docs