Skip to content
Raptor home
Menu

Alt text length

images.alt_over_100_chars
Priority
Low
Severity
Info

What we look for

Some images on these pages have alt text (a short written description of an image) longer than 100 characters.

Why it matters

Screen readers read alt text out in full, so a long one slows people down, and a description stuffed with keywords can look like spam to search engines.

How to fix

Cut each long description to a short phrase that says what the image shows, in the CMS media library or page template. Put longer explanations in a caption or the page text.

Where you’ll see it

The id is stable, and every surface uses it, so it’s the thing to search for or hand to an agent.

Terminal
When it is one of the five findings under Fix first, raptor crawl prints the id under it.
Check: images.alt_over_100_chars
crawl.json and the CSV
The crawl JSON names the finding by this id, and so do the CSV and raptor_query.
"check_id": "images.alt_over_100_chars"
The HTML report
This link opens the finding in the report, and each finding shows its id.
crawl.html#finding=images.alt_over_100_chars
MCP
raptor_findings with this check_id returns the finding in full, with a fix brief ready to paste into a task. If it didn’t fire, it says why.
raptor_findings {
  "job_id": "...",
  "check_id": "images.alt_over_100_chars"
}