Title: TDF Image Alt Scanner Author: willtdf Published: May 22, 2026 Last modified: May 22, 2026 --- Search plugins ![](https://ps.w.org/tdf-image-alt-scanner/assets/banner-772x250.png?rev=3543594) ![](https://ps.w.org/tdf-image-alt-scanner/assets/icon-256x256.png?rev=3543683) # TDF Image Alt Scanner By [willtdf](https://profiles.wordpress.org/willtdf/) [Download](https://downloads.wordpress.org/plugin/tdf-image-alt-scanner.0.1.3.zip) * [Details](https://wordpress.org/plugins/tdf-image-alt-scanner/#description) * [Reviews](https://wordpress.org/plugins/tdf-image-alt-scanner/#reviews) * [Installation](https://wordpress.org/plugins/tdf-image-alt-scanner/#installation) * [Development](https://wordpress.org/plugins/tdf-image-alt-scanner/#developers) [Support](https://wordpress.org/support/plugin/tdf-image-alt-scanner/) ## Description **TDF Image Alt Scanner** scans your entire WordPress site for images with missing or low-quality alt text and gives you a single place to fix them — across posts, pages, custom post types, the Media Library, and WooCommerce products. Missing alt text is one of the most common and most expensive mistakes on the web: * **SEO** — Google uses alt text to understand image content. Missing alts hurt image search rankings and reduce the contextual relevance of your pages. * **Accessibility** — Screen readers depend on alt text. Missing alts exclude users with visual impairments from understanding your content. * **Compliance** — WCAG 2.1 / 2.2 and the European Accessibility Act both require alt text on meaningful images. UK and EU sites that ignore this face increasing legal exposure. TDF Image Alt Scanner finds the gaps in minutes and gives you the tools to fix them. #### How it works 1. Click **Run scan**. The plugin walks your posts, pages, custom post types, Media Library, and WooCommerce galleries. 2. Each image is classified as **Missing**, **Decorative**, **Filename** (alt text equals the file name — useless to screen readers), or **Valid**. 3. The Results table shows everything in one place. Edit alt text inline; mark genuinely decorative images so they’re skipped by screen readers; export everything to CSV for review. 4. Re-run the scan whenever you want to see your compliance score improve. #### Free version features * Full site scan — every image on your site. * Compliance score dashboard with scan history. * Sortable, filterable bulk-edit table — filter by status, post type, or sort by date. * Inline edit and save per image, with “mark as decorative” toggle. * Detection of missing alt, decorative alt, and “alt equals filename” cases. * CSV export of every audit row. * Scans posts, pages, custom post types, Media Library, and WooCommerce products( including variations and gallery images). * Gutenberg-aware: handles core/image, core/cover, core/gallery, and nested blocks. #### Pro features (sold separately) * AI-generated alt text — bring your own API key (Anthropic Claude, OpenAI, or Gemini). * Per-image and bulk “Suggest with AI” actions, with review-before-save. * Configurable prompt templates: SEO-focused, accessibility-focused, e-commerce. * Multi-language alt text (30+ languages). * WooCommerce context-aware prompts (uses product name and category). * Scheduled re-scans (weekly / monthly). * Email and Slack reports of new missing alt text. * Branded PDF compliance reports referencing WCAG 2.1 / 2.2. * Compliance score trend chart over time. * Page builder integrations: Elementor, Beaver Builder, Bricks, Divi. * Cost estimator for AI bulk jobs. #### Privacy TDF Image Alt Scanner does not send any data off your site. The plugin only uses the WordPress REST API to communicate between the dashboard and your site’s database. If you upgrade to Pro and enable AI alt text generation, you will be entering your own API key for one of the supported AI providers. In that case, image URLs and prompts are sent directly from your site to the AI provider you’ve chosen — TDF Image Alt Scanner never sees or stores them. #### Source code & building from source The admin dashboard is a React app compiled with Vite. The unminified source is shipped inside the plugin zip at `admin/react/src/` and can be rebuilt with: ``` cd admin/react && npm install && npm run build ``` That regenerates the bundle at `admin/dist/`. Source files: `admin/react/src/*.jsx`,` admin/react/src/*.js`, `admin/react/src/styles.css`. Build config: `admin/react/ package.json`, `admin/react/vite.config.js`. ## Screenshots * [[ * Dashboard with compliance score, scan summary cards, and re-scan controls. * [[ * Results table — sortable, filterable, with inline editing. * [[ * Inline alt text editor with “mark as decorative” toggle. * [[ * Settings page for choosing which post types to scan. ## Installation #### From the WordPress.org plugin directory 1. Go to **Plugins Add New** in your WordPress admin. 2. Search for “TDF Image Alt Scanner”. 3. Click **Install Now**, then **Activate**. 4. Open the **TDF Image Alt Scanner** menu and click **Run first scan**. #### Manual installation 1. Download the plugin ZIP. 2. Upload to `/wp-content/plugins/tdf-image-alt-scanner/`. 3. Activate via **Plugins** in the WordPress admin. 4. Open the **TDF Image Alt Scanner** menu and click **Run first scan**. ## FAQ ### Does this work with WooCommerce? Yes. Product galleries, featured images, and variations are scanned automatically. WooCommerce-aware product context is part of the Pro AI prompts. ### Will it modify my images? No. The plugin only edits the alt text attribute of images you choose to update. Files, dimensions, and visual content are never changed. ### How does the “Filename” classification work? We compare the alt text against the image’s file name. If they match (after normalising case and stripping non-alphanumeric characters), the alt is flagged as “Filename”— technically present, but providing no useful information. ### Will scanning slow down my site? No. Scans run in the WordPress admin and use Action Scheduler (when available) for incremental processing. Front-end performance is not affected. ### What about images hardcoded in classic-editor post HTML? The scanner finds them and reports them in the Results table. Saving an alt text update applies to the underlying Media Library attachment. For images written directly into older post HTML, you may need to re-save the post for the new alt to appear on the front-end. Direct in-place HTML editing is on the roadmap. ### Will my data survive uninstalling? No. Uninstalling TDF Image Alt Scanner removes its custom database tables and settings cleanly. Image alt text edits made through the plugin remain in your media library. ### How do branded PDF reports work? Pro reports open in your browser ready to print. Use the “Save as PDF” button at the top of the report (or press Ctrl/Cmd + P Save as PDF). Every modern browser handles this — no extra software to install. Branding (logo, company name, footer text) is applied automatically. Advanced: if you have shell access and want server-side PDF generation (useful for automated workflows), run `composer require mpdf/mpdf` in the plugin folder; the plugin will detect it and generate PDFs directly. Most users do not need this. ### Is the plugin GPL-compatible? Yes. TDF Image Alt Scanner is released under GPLv2 or later, the same licence as WordPress itself. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “TDF Image Alt Scanner” is open source software. The following people have contributed to this plugin. Contributors * [ willtdf ](https://profiles.wordpress.org/willtdf/) [Translate “TDF Image Alt Scanner” into your language.](https://translate.wordpress.org/projects/wp-plugins/tdf-image-alt-scanner) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/tdf-image-alt-scanner/), check out the [SVN repository](https://plugins.svn.wordpress.org/tdf-image-alt-scanner/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/tdf-image-alt-scanner/) by [RSS](https://plugins.trac.wordpress.org/log/tdf-image-alt-scanner/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.1.3 * Ship the unminified React admin source inside the plugin zip (`admin/react/src/`) so anyone can rebuild the dashboard bundle. Build directions added to the readme. #### 0.1.2 * Renamed from “Alt Text Auditor” to “TDF Image Alt Scanner”. * Free scan is now uncapped — every image on the site is audited. * Code prefix changed to ALTAUD_/altaud_ to satisfy WP.org guideline 13. * Moved inline upgrade-page styles to wp_add_inline_style(). #### 0.1.0 * Initial development build. * Scanner, classifier, dashboard, results table, inline editor, settings page, CSV export. ## Meta * Version **0.1.3** * Last updated **3 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.2 or higher ** * Tested up to **6.9.4** * PHP version ** 8.1 or higher ** * Tags * [accessibility](https://wordpress.org/plugins/tags/accessibility/)[Alt Text](https://wordpress.org/plugins/tags/alt-text/) [images](https://wordpress.org/plugins/tags/images/)[seo](https://wordpress.org/plugins/tags/seo/) [wcag](https://wordpress.org/plugins/tags/wcag/) * [Advanced View](https://wordpress.org/plugins/tdf-image-alt-scanner/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/tdf-image-alt-scanner/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/tdf-image-alt-scanner/reviews/) ## Contributors * [ willtdf ](https://profiles.wordpress.org/willtdf/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/tdf-image-alt-scanner/)