Find and fix every missing alt text on your WordPress site.
TDF Image Alt Scanner scans your entire site for images with missing or low-quality alt text, and gives you a single place to fix them. Better SEO. Better accessibility. WCAG 2.2 and European Accessibility Act compliance, without the spreadsheet.
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 face increasing legal exposure.
TDF Image Alt Scanner finds the gaps in minutes and gives you the tools to fix them.
From audit to fix in four steps.
Run a scan
Click Run scan. The plugin walks your posts, pages, custom post types, Media Library, and WooCommerce galleries, including variations and gallery images.
Every image gets classified
Each image is tagged as Missing, Decorative, Filename (alt text equals the file name, useless to screen readers), or Valid.
Fix everything in one place
The Results table puts everything in one view. Edit alt text inline, mark genuinely decorative images so they're skipped by screen readers, and export to CSV for review.
Watch your score climb
Re-run the scan whenever you want. The compliance score dashboard shows progress over time, so you can prove the work is being done.
Free up to 500 images. Pro for everything else.
Start free. Upgrade only when you need AI, scheduled reports, or unlimited scans.
Everything you need to audit a site.
- Full site scan, up to 500 images per run
- 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
- Detects 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 & gallery images)
- Gutenberg-aware: handles
core/image,core/cover,core/gallery, and nested blocks
For agencies, larger sites, and ongoing compliance.
- Removes the 500-image scan cap
- 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
Start free. Go Pro when you need more.
- Go to Plugins → Add New in your WordPress admin
- Search for "TDF Image Alt Scanner"
- Click Install Now, then Activate
- Open the TDF Image Alt Scanner menu and run your first scan
- No 500-image scan cap
- AI alt text generation (Claude, OpenAI, Gemini) with your own key
- Scheduled re-scans plus email and Slack reports
- Branded PDF compliance reports for WCAG 2.1 / 2.2
- Page-builder integrations: Elementor, Beaver Builder, Bricks, Divi
Your data stays on your site.
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'll enter 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.
Questions, answered.
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.
What's shipped, what's next.
0.1.0: Initial development build
Not yet recommended for production sites.
- Scanner, classifier, dashboard, results table
- Inline editor, settings page, CSV export