Add alt text to all images at once — Windsurf

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 Windsurf

Codeium agentic AI IDE with Cascade

Windsurf Cascade can walk the entire project and apply multi-file edits in one pass. Paste the prompt below into your Windsurf 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 Windsurf

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

Using Windsurf Cascade, apply these edits across the project in one pass:

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 Windsurf

1. Open your Windsurf project.
2. Copy the prompt above with the copy button.
3. Paste into the Windsurf 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 Windsurf 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 Windsurf prompts

SEO