Add alt text to all images at once — Claude Code

Accessibility law (WCAG 2.1) and Google both require meaningful alt text on images. Doing it one-by-one is painful; bulk prompt does it in one pass.

rocket_launch

Fixing this in Claude Code

Anthropic's official terminal coding agent

Claude Code can grep the whole codebase first, plan the change, then edit every affected file. Paste the prompt below into your Claude Code chat and the fix rolls out across the project in one pass.

Using a different tool? Pick your stack:

Lovable Cursor Bolt v0 Replit Windsurf Claude Code Base44

The prompt for Claude Code

Copy and paste this into your Claude Code chat exactly as-is.

Run Claude Code in the project root and make these exact changes, scanning the whole codebase first:

Add alt text to all images

1. Add descriptive alt text to every <img> tag.
2. For decorative images use alt="" (empty string).

Why this matters

Most sites have 50-500 images scattered across components, blog posts, and product pages. Fixing alt one at a time is a week of work. Bulk-prompting an AI cuts it to an hour of review.

WCAG 2.1 level A compliance requires alt text on all informative images. This is a legal requirement in many jurisdictions (EAA, ADA).

How to use this prompt in Claude Code

1. Open your Claude Code project.
2. Copy the prompt above with the copy button.
3. Paste into the Claude Code chat and send.
4. Review the diff, accept the changes, redeploy.
5. Verify the fix using the checklist below.

Common mistakes to avoid

error_outlineAccepting every AI suggestion without review — AI sometimes hallucinates image content.
error_outlineUsing the filename as alt automatically.
error_outlineMissing `alt=""` on decorative images.

How to verify the fix worked

check_circle`document.querySelectorAll("img:not([alt])").length` === 0.
check_circleLighthouse Accessibility passes alt checks.
check_circleSpot-check 10 random images — alts are descriptive.

Frequently asked questions

Can AI write good alt text?expand_more

Often yes, but always review. Vision models describe images well but miss context (e.g., "why this image is here").

How long should alt be?expand_more

Under 125 characters. Describe meaning, not pixels.

Want all 34 prompts tailored to your Claude Code site?

Pantra scans your site in 10 seconds, detects the stack, and generates the exact prompts that apply — only the ones you actually need.

Scan my site

Related Claude Code prompts

SEO