Quick answer
Images should have an alt attribute.
HTML Missing Alt
Images should have an alt attribute. Missing alt hurts accessibility and validation.
Common causes
- <img> without alt.
- Empty alt for decorative image.
How to fix
- Add alt="description" for meaningful images.
- Use alt="" for decorative images.
HTML missing alt text is a common accessibility and validation issue that occurs when an image element does not include an alt attribute. Alt text helps screen readers describe images to users who cannot see them, and it also gives search engines and automated validators a clearer understanding of page content. This checker is useful for developers, content editors, QA teams, and accessibility reviewers who want to identify missing image descriptions before publishing. Fixing missing alt attributes improves semantic HTML quality, supports inclusive design, and reduces avoidable markup errors in audits and crawls.
How This Validator Works
This validator checks image markup for img elements that do not include an alt attribute. In HTML, alt text is part of the image’s accessible name and is used by assistive technologies, browser fallback behavior, and some automated quality tools. The validator scans the document structure, identifies image tags, and flags cases where the attribute is absent or empty when a meaningful description is expected.
- Detects img elements without an alt attribute
- Highlights images that may need descriptive alternative text
- Helps teams review accessibility and HTML conformance issues
- Supports faster QA for templates, CMS content, and generated pages
Common Validation Errors
- Missing alt attribute: The image tag has no alt property at all.
- Empty alt used incorrectly: An empty alt="" is present where a descriptive label is needed.
- Decorative image misclassified: Decorative images are not marked appropriately, which can confuse screen readers.
- Template-generated omission: CMS or component templates render images without a required alt field.
- Dynamic content gap: JavaScript-inserted images are added without accessible text.
Where This Validator Is Commonly Used
- Accessibility audits and WCAG review workflows
- Content management systems and editorial publishing checks
- Frontend component testing and design system QA
- SEO and technical content review pipelines
- Automated HTML validation in CI/CD or pre-launch checks
- Agency deliverables and client site quality assurance
Why Validation Matters
Alt text is a core part of accessible web content. When images lack alternative text, users who rely on screen readers may miss important information or context. Validation helps teams catch these issues early, especially in large sites where images are added by multiple editors, templates, or integrations. It also improves markup consistency, which is useful for technical audits, content governance, and long-term maintainability.
For some images, a missing alt attribute is a genuine accessibility problem. For purely decorative images, the correct solution may be an empty alt value rather than descriptive text. Validation is valuable because it encourages teams to make that distinction intentionally instead of leaving the attribute out by accident.
Technical Details
| HTML element | img |
| Required attribute | alt |
| Primary purpose | Provide a text alternative for the image |
| Accessibility relevance | Important for screen readers and assistive technologies |
| Common standards context | HTML semantics, accessibility best practices, WCAG-aligned content review |
In practice, alt text should describe the image’s function or content in context. If an image is decorative and does not add meaningful information, it may be appropriate to use an empty alt attribute so assistive technologies can skip it. If the image conveys information, the alt text should be concise, specific, and relevant to the surrounding content.
FAQ
What does “HTML missing alt” mean?
It means an image element was found without an alt attribute. This is usually treated as an accessibility and HTML quality issue because the image has no text alternative for users who cannot see it or for tools that rely on semantic markup.
Is every image required to have descriptive alt text?
Not always. Decorative images may use an empty alt="" so assistive technologies can ignore them. But if an image communicates information, supports navigation, or adds meaning to the page, it should have useful alternative text rather than no alt attribute at all.
Why do validators flag missing alt attributes?
Validators flag missing alt attributes because they are a common sign of inaccessible or incomplete HTML. The issue is easy to overlook in templates, CMS content, or generated pages, so automated checks help teams catch it before publishing or deployment.
Does missing alt text affect SEO?
Alt text is primarily an accessibility feature, but it can also help search engines understand image context. Missing alt text does not automatically cause ranking problems, but it can reduce semantic clarity and make image content harder to interpret in crawls and audits.
How do I fix a missing alt attribute?
Add an alt attribute to the image tag and write text that matches the image’s purpose. For example, a product photo might describe the product, while an icon button might describe the action it performs. If the image is decorative, use an empty alt value instead of leaving it out.
What is the difference between missing alt and empty alt?
Missing alt means the attribute is absent entirely. Empty alt means the attribute exists but contains no text, usually alt="". The difference matters because empty alt can be correct for decorative images, while missing alt is generally an error or omission.
Can automated tools tell me the correct alt text?
Automated tools can detect missing alt attributes, but they usually cannot determine the best descriptive text with full accuracy. Choosing good alt text depends on image context, page purpose, and user intent, so human review is often needed for final quality control.
Is alt text the same as a caption?
No. Alt text is embedded in the HTML and is used by assistive technologies and some automated systems. A caption is visible on the page and is meant for all users. They can complement each other, but they serve different functions.
When should I use an empty alt attribute?
Use an empty alt attribute when the image is purely decorative and does not add meaningful information. This tells screen readers to skip the image. If the image conveys content, action, or context, it should have descriptive alt text instead.
Related Validators & Checkers
- HTML Validator
- Accessibility Checker
- Image Attribute Checker
- Missing Title Attribute Checker
- Structured Data Validator
- Meta Tag Validator
FAQ
- Alt required?
- Yes for img.
- Decorative image?
- Use alt="".
Fix it now
Try in validator (prefill this example)