
Block Accessibility Checks
by Troy Chaplin on WordPress.org

Block Error Validation - Button block showing accessibility error with red border and detailed error message preventing publication, also demonstrates multiple errors in a grouped display
Block Accessibility Checks is a comprehensive WordPress plugin that ensures your content meets WCAG (Web Content Accessibility Guidelines) requirements. With real-time validation in the Gutenberg block editor, this plugin helps content creators and organizations maintain accessibility compliance effortlessly.
Key Features:
- Real-time Visual Feedback – See accessibility issues instantly with red borders around problematic blocks and detailed error messages in the block inspector panel
- Smart Publishing Control – Prevents publication of content with critical accessibility errors while allowing warnings with user awareness
- Extensive Block Coverage – Built-in checks for core WordPress blocks (images, buttons, tables, headings, galleries)
- Developer-Friendly – Comprehensive API with 12+ hooks and filters for custom accessibility checks
- External Plugin Support – Works seamlessly with custom blocks from third-party plugins and themes
- Unified Architecture – PHP-JavaScript integrated system ensures consistent validation everywhere
How It Works:
The plugin provides immediate feedback as you edit content. When accessibility issues are detected, blocks are highlighted with visual indicators and detailed messages explain how to fix the problems. Critical errors prevent publishing until resolved, while warnings allow publication with user acknowledgment.
Built-in Accessibility Checks:
- Button Blocks – Ensures buttons have both text content and proper link destinations
- Image Blocks – Requires alt text (unless marked decorative), validates length, prevents caption duplication
- Table Blocks – Requires proper headers or captions for screen reader navigation
- Heading Blocks – Configurable heading level restrictions to maintain proper hierarchy
- Gallery Blocks – Applies comprehensive image accessibility checks to all gallery items
Perfect For:
- Government websites requiring WCAG compliance
- Educational institutions with accessibility mandates
- Businesses committed to inclusive web content
- Developers building accessible WordPress themes and plugins
- Content teams who want accessibility guidance built into their workflow
Developer API:
Extend the plugin with custom accessibility checks for any block type. The robust API includes registration functions, validation hooks, and automatic JavaScript integration. Perfect for plugin developers who want to add accessibility validation to their custom blocks.
Getting Involved
If you would like to get involved and contribute to the development of this plugin or view it’s source code you can find more information in the plugins GitHub repo.