Important Notes About This Reference

WCAG 2.2 precedes and is the golden source for many content in this reference. We have linked any criteria we referred to alongside each suggestion specific to dapps.

The purpose of this reference is to build off the strong foundations WCAG, WAI-ARIA, and other groups such as WebAIM have provided. We cover points specific to the blockchain space applications, and we hope to eventually contribute back to WCAG as new standards emerge.

WCAG 2.x guidelines express accessibility criteria as level A, AA, AAA

WCAG Criteria Ranking. Ranking are represented with different cakes. Minimum A level is a slice of cake, Sufficient double A is a whole cake with one layer, and enhanced triple A is a two layer cake.
Which cake looks best?
A - Levels Explainer

A -> basic (often not enough)

AA -> sufficient (considered accessible from here and up)

AAA -> enhanced (step beyond just being accessible; better experience)

  • If you have achieved AAA you have achieved both AA and A. If you have achieved AA you have achieved A.

  • It is not always possible to achieve AAA in every instance, however it is of course preferably when it can be achieved.

  • Level A is truly the bare minimum, truly accessible dapps should be striving for AA in all cases. The majority of companies strive for AA according to WCAG.

  • Quote from WCAG 2.2 :

Note that even content that conforms at the highest level (AAA) will not be accessible to individuals with all types, degrees, or combinations of disability, particularly in the cognitive, language, and learning areas. Authors are encouraged to consider the full range of techniques, including the advisory techniques, Making Content Usable for People with Cognitive and Learning Disabilities, as well as to seek relevant advice about current best practice to ensure that Web content is accessible, as far as possible, to this community. Metadata may assist users in finding content most suitable for their needs.

In this reference guide we have included mainly AA and AAA level links as our source for dapp better practice proposal. Links to that criteria's numbered identifier are provided in expandable sections.

  • Note: WCAG 3.x is in draft phase at this time of writing. The criteria has changed for this version and will be based on a different system. We will await finalizations of this ongoing work before commenting further.

Last updated