Free Image Alt Text Checker

WordPress

1. In Media Library, click any image. The right sidebar has Alternative Text field. Fill it in.
2. For bulk editing, install Bulk Image Title Attribute and Alt Tag Pro (or similar) for batch operations.
3. Re-scan with this tool after the bulk edit to confirm the gaps are filled.

Webflow

1. In Designer, click any image element. The right panel has an Alt text field.
2. For CMS-driven images, set alt text in the Collection field and bind it to images via the template.
3. Publish and run a re-scan.

Shopify

1. Product images: in admin, click product, click image, fill in Alt text.
2. Theme images: in theme editor, settings have Alt text fields. Sometimes hard-coded in theme files (theme.liquid).
3. After updates, run scan on product, collection, and homepage URLs to confirm coverage.

Ghost

1. In post editor, click any image, the modal has an Alt text field.
2. For featured images, the post settings (gear icon) include alt text fields.
3. Run a re-scan. Ghost themes generally render alt text correctly when set.

Next.js / React

1. Use <img alt="..." /> or next/image with required alt prop. Lint rules (eslint-plugin-jsx-a11y) catch missing alt at build time.
2. For dynamic images from a CMS, set alt text as a required field in your data model.
3. Run the checker after deploy on representative URLs to verify.

Tool returns "0 images" but the page has images

Cause: Images load via background-image CSS, JavaScript-injected after page load, or lazy-load patterns that hide src.

Fix: For background images, switch to <img> tags. For JS-injected images, server-render them so HTML has the src on first load. Most modern lazy-load libraries are detected; very custom implementations may not be.

Tool times out on a URL

Cause: Target server is slow, blocked our IP via WAF, or has rate limiting.

Fix: Retry that URL alone after 30 seconds. If persistent, the site is blocking automated fetches; check the page's alt text manually via View Source.

CSV upload includes empty rows

Cause: CSV has trailing commas or whitespace.

Fix: Open the CSV in any text editor, remove blank lines, save, re-upload. Or just paste URLs directly into the textarea — the parser is more forgiving.

Pass count seems high but page has obvious problems

Cause: You reviewed Pass items but did not check whether alt text is descriptive.

Fix: Pass means "alt text exists" not "alt text is good". Click into Pass results and read the actual alt text. "image1.jpg" or "DSC_0042" technically passes but is functionally useless — rewrite descriptive.

Same image appears multiple times in results

Cause: A logo or icon appears in the header/footer of every page.

Fix: Expected behavior — the image is genuinely on every page. Fix the alt text once in your theme and it propagates everywhere. Re-scan to confirm.

Tool fails on a specific protected page

Cause: Page requires authentication.

Fix: Audit only public pages. For internal/protected pages, manually inspect via your authenticated browser and check alt text in DevTools or View Source.

Batch processing seems slower than non-batch

Cause: Some pages in the batch are very slow, holding up the whole group.

Fix: Standard mode processes pages sequentially with a per-URL timeout. Batch mode processes 10 in parallel, so the slowest one in each batch sets the time. For very mixed page speeds, standard mode may be more predictable.

Alt text contains the file name (e.g., "DSC_0042.jpg")

Cause: Default CMS behavior on some platforms when image is uploaded without explicit alt text.

Fix: Edit each image in your CMS to set descriptive alt text. WordPress, Webflow, and Shopify all have alt fields in the image edit modal. Bulk-edit via the CMS's Media Library if available.