WordPress Accessibility Coding Standard WordPress Accessibility Coding Standard

All new or updated code released in WordPress must conform with the WCAG 2.0 guidelines at level AA.

Top ↑

WCAG explained WCAG explained

When building a website or plugin, ask yourself these four questions:

  1. Is all content available to everyone? (Perceivable)
  2. Can visitors use all functionality? (Operable)
  3. Can visitors comprehend all content? (Understandable)
  4. Can visitors use any device? (Robust)

These are the four principles of Web Content Accessibility Guidelines (WCAG) of what a website should be: perceivable, operable, understandable and robust. (WCAG is part of the international World Wide Web Consortium.)

Perceivable Perceivable

Is all content available to everyone?

  • Provide text alternatives for non-text content (e.g., images).
  • Provide captions and other alternatives for multimedia.
  • Create content that can be presented in different ways without losing meaning.
  • Make it easy for users to see and hear content (e.g., by using color well, offering multimedia controls, and allowing text resizing).

Top ↑

Operable Operable

Can visitors use all functionality?

  • Make all essential functionality available from a keyboard.
  • Give users enough time to read and use content.
  • Do not use content that causes seizures.
  • Help users navigate and find content.

Top ↑

Understandable Understandable

Can visitors comprehend all content?

  • Make text readable and understandable.
  • Use easy-to-comprehend text — avoid complex wording.
  • Make content appear and operate in predictable ways.
  • Guide users to avoid and correct mistakes.

Top ↑

Robust Robust

Can visitors use any device?

  • Content must be able to be interpreted reliably by a wide variety of user agents, including assistive technologies.
  • All user interface components should have programmatically determinable names and roles.

Top ↑

Levels of Accessibility Levels of Accessibility

There are 3 levels of accessibility:

  1. A (basic)
  2. AA (the global accessibility standard)
  3. AAA (for dedicated software)

Most European Union and other countries use the accessibility standard WCAG 2.0 AA or equivalent for their government websites. Some countries require compliance with these guidelines for commercial websites, so the accessibility team uses these guidelines to improve WordPress core.

WCAG provides techniques for implementing its principles. Each issue has several solutions (techniques). Choose those that suit your theme or plugin best.

Use common sense when following WCAG techniques. Pick the one(s) that work well with your theme or plugin.

Decide which browser and versions your theme or plugin will support. Some WCAG techniques apply only to older browsers, e.g, Internet Explorer 7 and below.