Editoria11y Walkthrough

Editoria11y is a valuable accessibility checker designed specifically for Drupal. What sets it apart is its seamless integration into the editing experience. Results appear directly inline as you work—there's no need to click additional buttons or navigate to a separate dashboard. Helpful tips and alerts surface when relevant, whether you're viewing a published page or working within Drupal's editing interface.

The tool is purpose-built for content authors. It focuses exclusively on accessibility issues that authors can address themselves, such as missing alternative text or improper heading structure. More complex or technical issues, which require developer intervention, are intentionally left to other, more comprehensive accessibility testing tools.

Importantly, Editoria11y checks fully-rendered pages rather than just raw HTML or editor previews. This is particularly useful in Drupal, where pages are often composed of blocks, views, and other dynamic components. By evaluating the final assembled output, Editoria11y can catch issues that might otherwise go unnoticed in traditional checkers.

Overall, Editoria11y empowers content creators to contribute meaningfully to accessibility efforts, making it easier to build and maintain inclusive websites without requiring deep technical expertise.

Accessibility issues that must be fixed will appear as Red alerts, issues that need to be manually checked will appear as Yellow alerts. Pages with no detected issues will display a blue checkmark. These alerts will appear in the lower right corner of the page.

Editori11y alert stages. Blue checkmark for no issues, yellow for manual issues, and red for urgent issues.

 

 

Pages that have alerts will display the number of alerts found and provide you with the option to hover over or click the alert to view details about the issue and learn how to resolve it.

Editoria11y alert popup window displaying an urgent issue.

 

The Editoria11y control panel contains buttons to jump through the list of issues found, show and hide the inline tips, and restore dismissed alerts. The control panel will also help you visualize the page heading outline and image text alternatives.

Editoria11y control panel options to visualize headings and image text alternatives.

 

Here is a list of the issues that Editoria11y will check for. Items marked with (m) are “manual checks,” which are placed on content that may be OK as-is, depending on context. Authors can hide or dismiss manual checks. Definite problems, such as links with no text, can only be hidden by the site administrators.

  • Page structure that is meaningful for screen readers and search engines
    • Headings with no text at all
    • Tables without a header cell
    • Tables with empty header cells
    • Document headers (“Header 3”) inside table cells
    • Skipped heading levels (m)
    • Very long headings that might not be actual headings (m)
  • Text alternatives for images and media
    • Images without an alt element
    • Images marked as decorative using an empty alt element (m)
    • Images with a filename as alt text (m)
    • Images with very long alt text (m)
    • Alt text containing redundant text (m)
    • Video embeds, reminding the user to add closed captions (m)
    • Audio embeds, reminding the user to provide a transcript (m)
    • Social media embeds, reminding the user to provide alt elements (m)
    • Embedded visualizations that usually require a text alternative (m)
  • Links that meaningfully describe where they go
    • Links with no text
    • Links with a filename as their label (m)
    • Links made of only generic words: “click here,” “learn more,” “download,” etc. (m)
    • Links that open in a new window without warning (m)
    • Images in links with alt text that appear to be describing the image instead of the link destination (m)
    • Links to PDFs and documents, reminding the user to test the document for accessibility or provide an alternate format (m)
  • Visual-only formatting
    • Lists made from asterisks, numbers, and letters rather than list elements (m)
    • LARGE QUANTITIES F CAPS LCK TEXT (m)
    • Possible heading: suspiciously short black quotes (m)
    • Possible heading: short, all-bold paragraphs (m)

Editorial11y does not flag design issues (such as color contrast) or development issues (like invalid ARIA). It is meant to work alongside, not replace, tools designed for designers and developers.