Generic placeholder alt text should be avoided. Use descriptions that convey the image’s purpose or content.
Description
This rule identifies images, icons, and other visual elements that use generic or placeholder alternative text instead of meaningful descriptions. When alt text consists of vague terms like image
, photo
, banner
, or icon
, assistive technology users cannot understand the purpose or content of the visual. This undermines the core purpose of alternative text, which is to convey equivalent information to users who cannot see the image.
The rule checks img elements with an alt attribute, as well as non-image elements with role="img" (such as inline SVGs) that use aria-label or title for their accessible name. It detects generic standalone terms, short “image of” prefixes with minimal follow-up text, numbered placeholders like “Image 1”, and descriptions that start with a generic term but provide insufficient detail within 40 characters.
Disabilities impacted
- Visual impairments: users who are blind or have low vision rely on screen readers to announce alt text. Generic descriptions like “image” or “banner” give no useful information about what the image contains or why it is there.
- Cognitive disabilities: users with cognitive or learning disabilities benefit from consistent, descriptive labels that reinforce context. Placeholder text like
click here
orgraphic
adds cognitive load without clarifying purpose. - Motor disabilities: users who navigate via keyboard or switch devices depend on meaningful accessible names to orient themselves. Ambiguous alt text on interactive elements with
role="img"makes it harder to understand what action or content is associated with the element. - Deaf-blind users: braille display users who rely on text equivalents of visual content receive no useful information from placeholder alt text, making the image effectively invisible to them.
Why it matters
Alternative text is one of the most fundamental accessibility features on the web. W3C WAI guidance establishes that every meaningful image must have text that conveys its content or function. Generic alt text violates this principle and creates barriers for the millions of people who use screen readers daily. Beyond compliance, descriptive alt text improves WCAG conformance and demonstrates respect for all users. Search engines also use alt text to understand image content, so meaningful descriptions benefit SEO. Under the ADA and the European Accessibility Act, organizations may face legal consequences for inaccessible web content, and placeholder alt text is a common finding in accessibility audits.
Coding problems and solutions
Common coding problems
- Generic standalone terms: using alt text that is nothing but “image”, “photo”, “icon”, “banner”, “logo”, “button”, or “screenshot” without any identifying content.
- Numbered placeholders: setting alt text to
Image 1
,Banner 2
, orPhoto 3
, which tells the user nothing about the actual content. - Vague “of” phrases: writing
image of person
orphoto of building
without enough detail to distinguish this image from any other person or building photo. - Non-descriptive role=”img” labels: applying
role="img"to inline SVGs or other elements and then usingaria-label="icon"oraria-label="graphic"instead of describing the icon’s meaning. - Catch-all labels on interactive images: using generic terms like
button
orclick here
as alt text on clickable image elements, which obscures the element’s actual purpose.
How to fix it
Describe the image’s purpose or content
Replace generic alt text with a concise description that tells the user what the image shows or what function it serves. The description should be specific enough that a person who cannot see the image receives equivalent information.
<img src="team-photo.jpg" alt="SiteLint engineering team at the 2025 annual retreat in Portland"><img src="team-photo.jpg" alt="photo">Use descriptive labels for role=”img” elements
When using role="img" on inline SVGs or other non-image elements, the aria-label must describe what the icon or graphic represents, not the element type.
<svg role="img" aria-label="Close dialog" viewBox="0 0 24 24">
<path d="M18 6L6 18M6 6l12 12" stroke="currentColor" stroke-width="2"/>
</svg><svg role="img" aria-label="icon" viewBox="0 0 24 24">
<path d="M18 6L6 18M6 6l12 12" stroke="currentColor" stroke-width="2"/>
</svg>Avoid numbered or templated alt text
Do not use auto-generated or template-based alt text like “Image 1” or “Banner”. Each image should have a unique, context-specific description.
<img src="promo-banner.jpg" alt="Summer sale: 30% off all premium plans through August 31"><img src="promo-banner.jpg" alt="Banner 1">Go beyond vague “image of” prefixes
Writing “image of person” or “graphic of chart” provides almost no useful detail. Be specific about who, what, or why.
<img src="revenue-chart.png" alt="Bar chart showing quarterly revenue growth from Q1 to Q4 2025"><img src="revenue-chart.png" alt="chart of data">Mark decorative images explicitly
If an image is purely decorative and conveys no information, use an empty alt attribute so screen readers skip it. This prevents the rule from flagging it and avoids announcing useless text.
<img src="decorative-border.png" alt="" role="presentation"><img src="decorative-border.png" alt="image">Known Limitations
- Single-page applications (SPAs): images loaded dynamically after initial page render may not be caught if the audit runs before the DOM update completes.
- Shadow DOM: content inside shadow roots is not accessible to standard DOM queries, so images within shadow DOM may not be evaluated by this rule.
- Iframes: images embedded in cross-origin iframes are in a separate document context and cannot be inspected due to same-origin policy restrictions.
- Contextual ambiguity: the rule cannot determine whether a short alt description is truly non-descriptive in its specific context. A term like “logo” might be acceptable if followed by a brand name that the generic prefix check catches, but edge cases exist where short descriptions are still meaningful.
- Localized content: the list of generic terms is defined in English. Images with non-English generic placeholder text in other languages will not be detected.
- CSS background images: images applied via CSS
background-imageare not part of the DOM asimgelements and are outside the scope of this rule.
Resources
- W3C WAI – Images Tutorial
- WCAG 2.2 Technique F65 – Identifying non-text content with text alternatives
- MDN – img element: alt attribute
- WCAG 2.2 Success Criterion 1.1.1 – Non-text Content
- WAI-ARIA 1.2 – img Role
Rule
- Audit: accessibility
- Standard: SiteLint
- Level: Best practices
- Success Criteria: N/A
- Rule ID: unclear-image-description