media_accessibility_audit

Media Accessibility Audit helps site builders identify, review, and improve image alt text quality in Drupal using accessibility checks and optional AI-assisted suggestions—without automatic content changes.

Features

Media Accessibility Audit provides tools to evaluate and improve the accessibility of image media items in Drupal.

Core functionality includes:

• Auditing image media entities for missing, low-quality, or generic alt text
• Accessibility scoring based on WCAG-aligned heuristics
• A dedicated administrative dashboard for reviewing issues
• Batch processing support for large media libraries
• Drush command support for CLI-based audits

AI-assisted features:

• Generates alt text suggestions using the Drupal AI module
• Uses image vision models only when supported by the configured AI provider
• Displays suggestions as read-only previews
• Includes confidence indicators based on available context and vision support

Why use this module?

• Improve WCAG compliance for images
• Support editorial and accessibility review workflows
• Identify accessibility issues early without altering existing content
• Safely experiment with AI assistance without automatic changes
• This module is designed for accessibility audits, not content automation.

Post-Installation

After enabling the module:

1. Ensure the Media and Image core modules are enabled.
2. Configure an AI provider via:
   Administration → Configuration → AI
3. Set Default provider in AI settings chat option.
4. Navigate to: /admin/content/media-accessibility-audit
   Administration → Content → Media Accessibility Audit

From the dashboard, administrators can:

• View media items with detected alt text issues
• See accessibility scores and issue descriptions
• Preview AI-generated alt text suggestions
• Refresh suggestions per media item
• Apply suggestions individually or in bulk (manual confirmation required)
• Run batch audits for large media libraries

No new content types or fields are created by this module.

Additional Requirements

This module requires:

• Drupal 11.x
• Core Media module
• Core Image module
• Drupal AI module (drupal/ai)
• At least one AI provider configured via the AI module (optional, but required for suggestions)

AI-based features are automatically disabled if no compatible provider is available.

Usage

After enabling the module and configuring an AI provider, Media Accessibility Audit can be used in several ways depending on your workflow.

1. Media Accessibility Audit Dashboard (UI)

   Navigate to: /admin/content/media-accessibility-audit
   From the dashboard you can:
   Review media items with accessibility scores

   • See detected alt-text issues
   • Preview AI-generated alt text suggestions (read-only)
   • Apply suggested alt text to individual media items
   • Refresh suggestions per media item
   • No content is modified unless explicitly confirmed by an administrator.
2. Bulk Apply Alt Text (UI)

   From the dashboard, administrators can:

   • Select multiple media items
   • Apply AI-suggested alt text in bulk
   • Review confidence indicators before applying changes
   • Bulk actions always require explicit confirmation.
3. Batch Audit for Large Media Libraries (UI)

   For large sites, audits can be run using Drupal’s Batch API:

   • Start a batch audit from the dashboard
   • Media items are processed safely in chunks
   • Results appear progressively without timeouts
4. Drush Command (CLI)
   • Run audits from the command line:
     drush media_accessibility_audit:audit
   • For large sites, use batch-safe mode:
     drush media_accessibility_audit:audit --batch

   This is useful for CI pipelines, cron-based reviews, or large media libraries.

5. Single Media Review

   Each media item can be reviewed individually:

   • View detected alt-text issues
   • Preview AI suggestions
   • Apply changes manually if desired

Similar projects

Other modules focus on accessibility reporting or automatic content generation.

Media Accessibility Audit differs by:

• Focusing specifically on image alt text quality
• Avoiding automatic content modification
• Providing AI suggestions as explicit, user-approved previews
• Supporting both UI-based and CLI-based workflows
• Emphasizing responsible AI usage and transparency

Supporting this Module

Contributions, bug reports, and feature suggestions are welcome via the Drupal.org issue queue.

If you are interested in sponsoring development or contributing patches, please open an issue to start the discussion.

Community Documentation

Documentation, examples, and usage guidance are maintained in the project README and issue queue.

Future resources may include:

• Walkthrough videos
• Example dashboards
• Best-practice guides for accessible alt text