TamizhApps Bulk Image Alt Text Manager

By TamizhApps

0+ active installationsVersion 1.0.1

Audit and bulk edit image ALT text across Media Library, Theme folders, and Site Editor (FSE) templates with WCAG 1.1.1 decorative image support.

Description

TamizhApps Bulk Image Alt Text Manager is a lightweight accessibility (WCAG) and image SEO auditing tool built for modern WordPress (Block Themes, Full Site Editing, and classic setups).

How This Plugin Stands Out

Most existing ALT text plugins only query wp_posts (post_type = 'attachment') and either ignore modern Block Theme assets or modify post_content directly with regex (which often triggers “This block contains unexpected or invalid content / Attempt Block Recovery” in Gutenberg).

TamizhApps Bulk Image Alt Text Manager bridges this gap with three modern WordPress capabilities:

  1. Active Theme Folder & Site Editor (FSE) Block Template Auditing: In addition to the Media Library, the plugin scans your active and parent theme directories (get_stylesheet_directory() / get_template_directory()) and maps image usage across Full Site Editing (wp_template and wp_template_part) block templates.
  2. Non-Destructive Render-Time Injection via WP_HTML_Tag_Processor: Uses WordPress Core’s WP_HTML_Tag_Processor API on render_block, the_content, post_thumbnail_html, and widget_text_content to dynamically inject missing alt attributes and decorative roles at render time—never corrupting stored Gutenberg block grammar.
  3. First-Class WCAG 2.1 SC 1.1.1 Decorative Image Toggle: Purely decorative images (dividers, background flourishes, icons) should not be stuffed with SEO keywords. You can mark any Media Library or Theme image as Decorative (WCAG 1.1.1) so it counts as compliant in your accessibility score and outputs alt="" role="presentation" for screen readers.

Key Features

  • Find Missing ALT Text Across Media & Theme Folders: Instantly view total images, missing ALT counts, WCAG decorative counts, and an overall WCAG & SEO compliance score.
  • Fast Inline Bulk Editor Table: View thumbnails, source badges (Media Library or Theme), FSE Block Template context, dimensions, and live character counters.
  • Smart Filename-to-ALT Suggestions: Automatically strips file extensions, camera prefixes (IMG_1234, DSC_), and WordPress size suffixes (-1024x768, -scaled) with live Sentence case, Title Case, and lowercase formatting.
  • One-Click & Keyboard-Driven Saving: Save individual rows, batch-save modified rows (Ctrl+S / Cmd+S), or auto-fill all non-decorative missing ALT text site-wide without opening images one by one.
  • Filter by Status & Source: Filter by All Status, Missing ALT, Has ALT, or Decorative (WCAG), and by All Sources, Media Library, or Theme & FSE.
  • CSV Audit Export: Export all or filtered image data (including source, FSE template context, and WCAG status) to an Excel-compatible UTF-8 CSV file.

Installation

  1. Upload the tamizhapps-bulk-image-alt-text-manager folder to /wp-content/plugins/, or install the plugin through the WordPress Plugins screen.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Navigate to Media > Bulk ALT Text to audit, suggest, mark decorative images, bulk edit, and export your image ALT text.

FAQ

How does this plugin avoid breaking Gutenberg blocks when updating ALT text?

Instead of running destructive regex replacements on post_content, the plugin stores ALT text in attachment/theme metadata and uses WordPress Core’s WP_HTML_Tag_Processor at render time (render_block and the_content) to populate missing alt attributes safely.

Why is there a “Decorative (WCAG 1.1.1)” toggle?

Under WCAG 2.1 Success Criterion 1.1.1, purely decorative images must have an empty alt="" attribute (role="presentation") so screen readers skip them. Marking an image as Decorative prevents false “Missing ALT” warnings while keeping your site accessible.

Does this plugin require an external AI API or paid account?

No. It runs 100% locally inside WordPress with zero external API dependencies.

Screenshots

Changelog

1.0.1

  • Unified plugin slug and text domain to tamizhapps-bulk-image-alt-text-manager.
  • Updated Contributors header to pluginsdock.
  • Added WCAG 2.1 SC 1.1.1 Decorative Image toggle (alt="" + role="presentation" via WP_HTML_Tag_Processor).
  • Added Full Site Editing (FSE) Block Template (wp_template / wp_template_part) image usage mapping.
  • Fixed all Plugin Check (PCP) nonce verification and domain path warnings.

1.0.0

  • Initial release of TamizhApps Bulk Image Alt Text Manager.