Bulk-Fix Alt Text Without Keyword Stuffing

Key takeaways

• Google treats alt text as the most important image metadata. It helps screen reader users and helps Google understand the image.
• Good alt text describes the image in context. Keyword-stuffed alt text can look like spam.
• If an image is a link, its alt text acts as the anchor text.
• Fix at scale by auditing first, previewing the changes, then applying.

Why does alt text matter?

Google's image guidance describes alt text as informative text for people using screen readers or slow connections, and says Google uses it together with computer vision and the surrounding page to understand an image. If the image is also a link, the alt text works as its anchor text.

What do good and bad look like?

Google's own examples:

For a travel blog the equivalent:

(These are formatting examples; write the real description from your photo.)

How do I fix hundreds of images safely?

1. Audit. Run audit_media_hygiene to list images with missing or weak alt text.
2. Preview. bulk_fix_media_hygiene supports a dry run so you see proposed text before anything changes.
3. Review a sample of 20 and edit the rule if the output is vague.
4. Apply. Say OK and let it write.
5. Re-audit to confirm the count dropped.

The agent can see the post context when it writes alt text, which is the difference between "image 12" and "Chunchi Falls in monsoon". It still can't see your intent, so skim a sample. See Dry-Run Bulk Edits.

Rules for writing it

• Describe what is in the image, as you would to someone who can't see it.
• Add the place or subject name when it's clear from the post.
• Skip "image of" and "picture of".
• Leave decorative images with empty alt rather than inventing text.
• Don't repeat the same keyword in every alt.
• For inline SVG, Google says to use a <title> element referenced with aria-labelledby.

A quick review table for the preview

Common mistakes

• Using the post title as the alt for every image.
• Describing the photo wrongly because the agent lacked context.
• Fixing alt text but leaving huge image files; check media hygiene as well.

Frequently asked questions

Is there a length limit? The sources used here don't give one. Keep it to a clear sentence.

Does alt text help rankings? Google says it uses it to understand images; treat it as accessibility first.

What about the filename? Descriptive names help, but alt is the main field.

Try it

Try Roami and run a media audit. Related: Dry-Run Bulk Edits, Blog SEO Audit Checklist.

Sources (checked 18 Oct 2026)

• Google: Image SEO best practices