How to fix “Image buttons must have alternative text”
By Justin Zagar · Updated
A form button made from a picture (input type="image") has no alt text. Add an alt attribute that names what the button does, like alt="Search" or alt="Subscribe".
- axe rule
input-image-alt- WCAG
- 1.1.1 Non-text Content (Level A) and 4.1.2 Name, Role, Value (Level A)
- Lighthouse
- Google Lighthouse and PageSpeed Insights report it as “<input type="image"> elements do not have [alt] text”
What it means
An image button submits a form, and its picture is the only thing on it. The alt text becomes the button's name, so it should say the action, not describe the picture. "Search" is right. "Magnifying glass" isn't.
These are less common than they used to be, but they still turn up in older search boxes, newsletter forms and PayPal style buy buttons.
Who it affects
People who use a screen reader or voice control.
How to find it
- Run the free checker. It lists each input with type="image".
How to fix it
- Add alt text that names the action.
- Or swap the image button for a regular button with text, styled to look the way you want.
A search button
<input type="image" src="go.png"><input type="image" src="go.png" alt="Search">What a scanner can and can’t tell you
Fixing this clears one automated check. It doesn’t mean the page is accessible, and it doesn’t settle any legal question. Automated tests catch only part of the problems. W3C puts it plainly: evaluation tools “can not determine accessibility, they can only assist in doing so.” The rest takes a person working through the site with a keyboard and a screen reader.
Source: W3C WAI, Selecting Web Accessibility Evaluation Tools. Not legal advice.
Sources
All checked November 8, 2026. The rule wording is axe-core 4.14.0’s own.
Related fixes
- Images must have alternative text
Images without alt text
- Buttons must have discernible text
Buttons with no text
Check a page for free
Scan any page of your site against WCAG 2.1 AA in about 30 seconds. You get the problems automated testing finds, in plain words, with a link to a fix guide for the common ones.
Rather have someone fix it for you? Tell me about your site.