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:
- 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_templateandwp_template_part) block templates. - Non-Destructive Render-Time Injection via
WP_HTML_Tag_Processor: Uses WordPress Core’sWP_HTML_Tag_ProcessorAPI onrender_block,the_content,post_thumbnail_html, andwidget_text_contentto dynamically inject missingaltattributes and decorative roles at render time—never corrupting stored Gutenberg block grammar. - 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 LibraryorTheme), 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.
Screenshots


Installation
- Upload the
tamizhapps-bulk-image-alt-text-managerfolder to/wp-content/plugins/, or install the plugin through the WordPress Plugins screen. - Activate the plugin through the Plugins menu in WordPress.
- 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’sWP_HTML_Tag_Processorat render time (render_blockandthe_content) to populate missingaltattributes 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.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“TamizhApps Bulk Image Alt Text Manager” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “TamizhApps Bulk Image Alt Text Manager” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- Unified plugin slug and text domain to
tamizhapps-bulk-image-alt-text-manager. - Updated
Contributorsheader topluginsdock. - Added WCAG 2.1 SC 1.1.1 Decorative Image toggle (
alt=""+role="presentation"viaWP_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.
