Check content accessibility with Editoria11y

The Editoria11y assistant checks your content against a set of accessibility rules and warns about any issues it finds. Its guidance is actionable and clear, so you can identify, understand, and fix issues, and learn as you go. This page installs the Accessibility Tools add-on and puts both the inline assistant and the sitewide report to work.

Goal

The Accessibility Tools add-on installed, the Editoria11y assistant reviewing pages as you edit them, and the sitewide report locating remaining issues.

Prerequisites

• A running Drupal CMS site and an administrator account.
• The concepts behind the checks; see Accessibility essentials.

Steps

Install the Accessibility Tools add-on

1. Go to Extend → Recommended add-ons/admin/modules/browse/recommended.
2. Select Install on the Accessibility Tools add-on.

Add-ons install the same way across Drupal CMS; see Add features with recommended add-ons.

Try the assistant on the demo page

The add-on provides a demo content item that shows the checks in action:

1. In the admin navigation, go to Content/admin/content.
2. Locate the Accessibility Tools demo page content item in the list.
3. Select the link to view the page, or choose Edit from the dropdown menu.
4. In both cases, an inline accessibility report appears with tips about how to improve the page content.

Read the assistant’s icons

The assistant appears as a small widget, a flag or badge icon, in the lower corner of the content editing interface and alongside your content as you preview pages on the site:

• A blue widget with a checkmark, next to summary and checklist icons, means no issues were found.
• A red widget with a flag icon and a count means the assistant found that many issues or warnings.

Check your own content

The accessibility checks work on any content on your site, both on content pages and in content editing forms. Open one of your own pages or its edit form and review what the widget reports.

Review the sitewide report

The inline assistant only covers the page in front of you. For the whole site:

1. Go to Reports → Content Accessibility/admin/reports/editoria11y.
2. Browse the report to identify, and fix, accessibility issues across your site’s content.

The report catches issues on pages nobody has opened recently, or that appeared as content evolved.

Verify

• The Editoria11y widget appears in the lower corner when you view or edit content.
• The Accessibility Tools demo page shows a red widget with a count of issues and tips for fixing them.
• Reports → Content Accessibility lists the issues found across the site.

Related

• Accessibility essentials explains the concepts behind the warnings.
• Editoria11y project describes how the checker works and what its warnings mean.
• W3C Introduction to Web Accessibility and WebAIM’s guide to clear writing go deeper on the fundamentals.