Title: Block Accessibility Checks
Author: Troy Chaplin
Published: <strong>Ọ̀wàrà 6, 2024</strong>
Last modified: Igbe 15, 2026

---

Ṣàwárí àwọn plugin

![](https://ps.w.org/block-accessibility-checks/assets/banner-772x250.png?rev=3365068)

![](https://ps.w.org/block-accessibility-checks/assets/icon-256x256.png?rev=3377660)

# Block Accessibility Checks

 Láti ọwọ́ [Troy Chaplin](https://profiles.wordpress.org/areziaal/)

[Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/block-accessibility-checks.3.0.2.zip)

 * [Àwọn àlàyé](https://yor.wordpress.org/plugins/block-accessibility-checks/#description)
 * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/block-accessibility-checks/#reviews)
 *  [Ìgbéwọlẹ̀](https://yor.wordpress.org/plugins/block-accessibility-checks/#installation)
 * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/block-accessibility-checks/#developers)

 [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/block-accessibility-checks/)

## Àpèjúwe

[Block Accessibility Checks](https://blockaccessibilitychecks.com/) is a comprehensive
WordPress plugin that proactively prevents accessibility issues in your content 
before they reach your audience. Designed for the Gutenberg block editor, it provides
real-time validation with a three-tier system that ensures your blocks, post meta
fields, and overall document structure meet WCAG (Web Content Accessibility Guidelines)
requirements.

Unlike reactive accessibility tools that scan published content, this plugin catches
problems during the editing process—giving immediate visual feedback and preventing
publication of content with critical accessibility errors. Content creators get 
clear guidance on what needs fixing, while developers can extend the system with
custom checks for blocks, meta fields, and editor-level validation.

Whether youÌtumọ̀ Yorùbá: ’re a content creator ensuring your posts are accessible,
a developer building accessible blocks, or an organization maintaining compliance
standards, Block Accessibility Checks provides the tools you need to create inclusive
content effortlessly.

**Features for Content Creators & Editors:**

 * **Real-time Visual Feedback** Ìtumọ̀ Yorùbá: – See accessibility issues instantly
   with color-coded borders (red for errors, yellow for warnings) around problematic
   blocks and detailed error messages in the block inspector panel
 * **Smart Publishing Control** Ìtumọ̀ Yorùbá: – Critical accessibility errors prevent
   publishing until resolved, while warnings allow publication with user awareness
 * **Comprehensive Block Coverage** Ìtumọ̀ Yorùbá: – Built-in validation for images,
   buttons, tables, headings, and galleries with clear guidance on how to fix issues
 * **Document-Wide Validation** Ìtumọ̀ Yorùbá: – Advanced heading hierarchy checking
   prevents skipped heading levels and ensures proper content structure across your
   entire post
 * **Title Validation** Ìtumọ̀ Yorùbá: – Ensures posts and pages have a title set
   for accessibility and SEO, validates in real-time as you type
 * **Intelligent URL Validation** Ìtumọ̀ Yorùbá: – Real TLD validation using the
   Public Suffix List ensures only legitimate domains are accepted in button links
 * **Configurable Settings** Ìtumọ̀ Yorùbá: – Control which checks are errors (prevent
   publishing), warnings (allow with notice), or disabled through an intuitive admin
   interface
 * **Grouped Error Display** Ìtumọ̀ Yorùbá: – All accessibility issues shown at 
   once in organized groups, eliminating the “fix one, see another” frustration
 * **Works Everywhere** Ìtumọ̀ Yorùbá: – Validation runs in both the post editor
   and site editor (templates/template parts) with separate configurable settings

**Features for Developers & Plugin Authors:**

 * **Three-Tier Validation API** Ìtumọ̀ Yorùbá: – Register custom checks for block
   attributes, post meta fields, and editor-level validation using comprehensive
   hooks and filters
 * **JavaScript-Only Validation** Ìtumọ̀ Yorùbá: – All validation logic runs in 
   JavaScript for real-time editor feedback without server round-trips
 * **Automatic Settings Integration** Ìtumọ̀ Yorùbá: – External plugins automatically
   get their own settings pages under the Block Checks menu
 * **External Plugin Support** Ìtumọ̀ Yorùbá: – Works seamlessly with custom blocks
   from third-party plugins and themes
 * **Extensive Hook System** Ìtumọ̀ Yorùbá: – 20+ action and filter hooks for complete
   customization of registration, validation, and display behavior
 * **Well-Documented API** Ìtumọ̀ Yorùbá: – Complete developer documentation with
   quick start guides and working code examples

**How It Works:**

The plugin provides immediate feedback as you edit content through a sophisticated
three-tier validation system:

 1. **Block Validation** Ìtumọ̀ Yorùbá: – Validates individual block attributes in 
    real-time as you type and edit
 2. **Meta Field Validation** Ìtumọ̀ Yorùbá: – Checks required post meta fields with
    automatic post locking when validation fails
 3. **Editor-Level Validation** Ìtumọ̀ Yorùbá: – Validates document-wide concerns like
    heading hierarchy that span across multiple blocks

When accessibility issues are detected, they are highlighted with visual indicators(
red for errors, yellow for warnings) 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** Ìtumọ̀ Yorùbá: – Ensures buttons have descriptive text content
   and validates link destinations using real TLD validation (Public Suffix List)
 * **Image Blocks** Ìtumọ̀ Yorùbá: – Requires alt text (unless marked decorative),
   validates alt text length (warns if exceeding 125 characters), prevents caption
   duplication, and detects non-descriptive patterns like “image of” or “photo123”
 * **Table Blocks** Ìtumọ̀ Yorùbá: – Requires proper headers or captions for screen
   reader navigation
 * **Heading Blocks** Ìtumọ̀ Yorùbá: – Validates proper heading hierarchy across
   entire document (prevents skipped levels), ensures appropriate first heading 
   level (H2 recommended, H1 allowed with warnings), and provides configurable heading
   level restrictions (H1, H5, H6 can be disabled)
 * **Gallery Blocks** Ìtumọ̀ Yorùbá: – Applies comprehensive image accessibility
   checks to all gallery items (alt text, length, patterns, caption duplication)
 * **Post & Page Title Validation** Ìtumọ̀ Yorùbá: – Ensures posts and pages have
   a title set for accessibility and SEO, validates in real-time as users type, 
   prevents publishing content without a title, configurable independently for posts
   and pages
 * **Post Meta Fields** Ìtumọ̀ Yorùbá: – Validate required custom fields with real-
   time validation, automatic post locking for errors, and seamless integration 
   with block validation system

**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 Resources:**

Extend the plugin with [custom accessibility checks](https://github.com/troychaplin/block-accessibility-checks/blob/main/docs/)
using the comprehensive validation API. See the complete [developer documentation](https://github.com/troychaplin/block-accessibility-checks/blob/main/docs/)
for quick start guides, API reference, code examples, and a [working example plugin](https://github.com/troychaplin/block-check-integration-example).

### Getting Involved

If you would like to get involved and contribute to the development of this plugin
or view itÌtumọ̀ Yorùbá: ’s source code you can find more information in the [plugins GitHub repo](https://github.com/troychaplin/block-accessibility-checks).

## Àwọn àwòrán ìbòjú

 * [[
 * **Validation Sidebar** Ìtumọ̀ Yorùbá: – A custom sidebar displays error and warning
   messages that link to blocks in the content area
 * [[
 * **Validation Popover** Ìtumọ̀ Yorùbá: – Blocks with issues have an inline indicator
   that trigger an information popover on click
 * [[
 * **Comprehensive Settings Panel** Ìtumọ̀ Yorùbá: – Plugin configuration page with
   granular control over accessibility check severity levels
 * [[
 * **External Plugin Validation** Ìtumọ̀ Yorùbá: — An external plugin with a Band
   custom post type, card block and post meta that leverage the Validation API
 * [[
 * **External Plugin Settings Panel** Ìtumọ̀ Yorùbá: — An external plugin integrated
   into the settings page grouped by block, post meta and editor validation options

## Ìgbéwọlẹ̀

**From WordPress Admin:**
 1. Go to **Plugins  Add New** in your WordPress admin
2. Search for “Block Accessibility Checks” 3. Click “Install Now” and then “Activate”
4. Navigate to **Block Checks  Core Block Checks** to configure your preferences

**Manual Installation:**
 1. Download the plugin files and upload to `/wp-content/
plugins/block-accessibility-checks/` 2. Activate the plugin through the **Plugins**
menu in WordPress 3. Configure your accessibility check preferences in the settings

**After Installation:**
 The plugin works immediately after activation with sensible
defaults. You can customize settings at:

 * **Block Checks  Core Block Validations** Ìtumọ̀ Yorùbá: – Configure core WordPress
   block validation
 * **Block Checks  Editor Validation** Ìtumọ̀ Yorùbá: – Configure post/page title
   validation
 * **Block Checks  Meta Field Checks** Ìtumọ̀ Yorùbá: – Configure post meta field
   validation (if any registered)
 * **Block Checks  Site Editor Checks** Ìtumọ̀ Yorùbá: – Configure validation for
   site editor (templates/template parts)
 * **Block Checks  [External Plugin Name]** Ìtumọ̀ Yorùbá: – Configure validation
   for external plugin blocks (automatically created)

## FAQ

### How do I use this plugin?

 1. Once activated, navigate to **Block Checks  Core Block Checks** to configure your
    preferences
 2. Choose which checks should be errors (prevent publishing), warnings (allow publishing
    with notice), or disabled
 3. Start editing content in the Gutenberg editor Ìtumọ̀ Yorùbá: – accessibility checks
    run automatically across blocks, meta fields, and document structure
 4. Blocks with issues will show red borders (errors) or yellow borders (warnings) 
    with detailed messages in the block inspector panel
 5. Fix the highlighted issues or adjust check severity levels as needed

### What happens when accessibility issues are found?

The plugin provides immediate visual feedback through its three-tier validation 
system:
 * **Red borders and icons** around blocks with critical accessibility errors***
Yellow borders and icons** around blocks with warnings * **Detailed error messages**
in the block inspector sidebar panel, grouped by severity and category * **Publishing
prevention** for critical errors in blocks, meta fields, or editor-level checks (
configurable) * **Warning indicators** for less critical issues that still allow
publishing with user awareness * **Post locking** when required meta fields fail
validation

### Can I add custom accessibility checks for my own blocks?

Yes! The plugin includes a comprehensive [developer API](https://github.com/troychaplin/block-accessibility-checks/blob/main/docs/)
with extensive hooks and filters. You can register custom accessibility checks for:

 * **Block validation** Ìtumọ̀ Yorùbá: – Any block type using the `ba11yc_register_checks`
   action
 * **Meta field validation** Ìtumọ̀ Yorùbá: – Post meta fields using the `ba11yc_register_meta_checks`
   action
 * **Editor-level validation** Ìtumọ̀ Yorùbá: – Document-wide checks using the `
   ba11yc_register_editor_checks` action

See the developer documentation for complete examples and quick start guides.

### Does this work with blocks from other plugins?

Absolutely! The pluginÌtumọ̀ Yorùbá: ’s architecture supports any WordPress block,
whether from core, themes, or third-party plugins. External plugins automatically
get their own settings page under the Block Checks menu, allowing administrators
to configure validation levels for each check independently.

### Can I configure which checks are errors vs warnings?

Yes, all checks can be configured as errors (prevent publishing), warnings (allow
publishing with notice), or disabled entirely. Visit **Block Checks** in your WordPress
admin to access:

 * Core block check settings
 * Meta field check settings
 * Site editor check settings
 * External plugin check settings (automatically created)

### Can I validate required post meta fields?

Yes! The plugin includes a comprehensive meta field validation system. Register 
required meta fields using the `ba11yc_register_meta_checks` action hook, implement
JavaScript validation using the `ba11yc_validate_meta` filter, and the plugin will
automatically lock post saving when validation fails, provide visual feedback, and
integrate seamlessly with block validation.

### Does this work in the site editor?

Yes! The plugin works in both the post editor and site editor. The site editor has
separate configurable settings accessible at **Block Checks  Site Editor Checks**,
allowing you to configure different validation rules for template/template part 
editing versus post-level content.

### Will this slow down my editor?

No, the plugin is optimized for performance with smart caching and efficient validation
algorithms. All validation runs in JavaScript for real-time feedback without server
round-trips. Checks run in real-time without impacting editor responsiveness.

### How to uninstall the plugin?

Simply deactivate and delete the plugin through the WordPress admin interface.

## Àwọn àgbéyẹ̀wò

Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.

## Àwọn Olùkópa & Olùgbéejáde

“Block Accessibility Checks” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí
ti ṣe ìkópa sí plugin yìí.

Àwọn Olùkópa

 *   [ Troy Chaplin ](https://profiles.wordpress.org/areziaal/)
 *   [ mikecorkum ](https://profiles.wordpress.org/mikecorkum/)

A ti túmọ̀ “Block Accessibility Checks” sí èdè agbègbè 1 kan. Ọpẹ́lọpẹ́ fún [àwọn atúmọ̀ èdè](https://translate.wordpress.org/projects/wp-plugins/block-accessibility-checks/contributors)
fún àwọn ìkópa wọn.

[Túmọ̀ “Block Accessibility Checks” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/block-accessibility-checks)

### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

[Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/block-accessibility-checks/),
ṣàyẹ̀wò [ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/block-accessibility-checks/),
tàbí ṣe àgbékalẹ̀ sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/block-accessibility-checks/)
nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/block-accessibility-checks/?limit=100&mode=stop_on_copy&format=rss).

## Àkọsílẹ̀ àwọn àyípadà

View the [changelog](https://blockaccessibilitychecks.com/changelog/) on the plugin
website.

## Àkójọpọ̀ Meta

 *  Ẹ̀yà **3.0.2**
 *  Ìgbàgbọ́hùn tó kẹ́yìn **oṣù 2 sẹ́yìn**
 *  Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **10+**
 *  Ẹ̀yà WordPress ** 6.7 tàbí ju bẹ́ẹ̀ lọ **
 *  Dánwò dé **6.9.4**
 *  Ẹ̀yà PHP ** 7.0 tàbí ju bẹ́ẹ̀ lọ **
 *  Àwọn èdè
 * [English (US)](https://wordpress.org/plugins/block-accessibility-checks/) àti
   [Italian](https://it.wordpress.org/plugins/block-accessibility-checks/).
 *  [Túmọ̀ sí èdè rẹ](https://translate.wordpress.org/projects/wp-plugins/block-accessibility-checks)
 * Àwọn àmì
 * [accessibility](https://yor.wordpress.org/plugins/tags/accessibility/)[blocks](https://yor.wordpress.org/plugins/tags/blocks/)
   [gutenberg](https://yor.wordpress.org/plugins/tags/gutenberg/)[validation](https://yor.wordpress.org/plugins/tags/validation/)
   [wcag](https://yor.wordpress.org/plugins/tags/wcag/)
 *  [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/block-accessibility-checks/advanced/)

## Àwọn ìbò

Kò sí ìwádìí tí a tíì fi ránṣẹ́.

[Your review](https://wordpress.org/support/plugin/block-accessibility-checks/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/block-accessibility-checks/reviews/)

## Àwọn Olùkópa

 *   [ Troy Chaplin ](https://profiles.wordpress.org/areziaal/)
 *   [ mikecorkum ](https://profiles.wordpress.org/mikecorkum/)

## Ìrànlọ́wọ́

Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́?

 [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/block-accessibility-checks/)