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.