SEO025 · Image alt text

Severity: warning

What it checks

Flags an <img> with no alt attribute. An explicit empty alt="" is a valid signal for purely decorative images and passes. A spread ({...rest}) may supply alt, so it is not flagged. This rule runs in static (CLI) analysis only — the same mode that collects <img> elements.

Why it matters

An <img> with no alt attribute is invisible to image search and assistive technology. A descriptive alt is an image-SEO signal and improves accessibility.

How to fix

<img src="/photo.jpg" width="800" height="600" alt="Description of the image" />

<!-- Purely decorative image: -->
<img src="/divider.svg" alt="" />