Skip to main content
All rules

A11Y-017

Image buttons have no text alternative

HighDefault severity · Accessibility · Accessibility (WCAG 2.2 AA)

Last reviewed

What it checks

<input type="image"> without alt, aria-label or aria-labelledby.

Why it matters

The button (often "submit" or "search") is announced with no name, so screen-reader users cannot use the form.

Recommended fix

Add alt text that says what the button does.

How to verify

Check with axe or a screen reader that each image button is announced with its action.

Example fix prompt

Generic prompt (your report adds the evidence)
Please fix this production issue in my app.

Issue A11Y-017: Image buttons have no text alternative
Site: https://your-app.example

First confirm the issue in the code or live config. If it is not present, say so and change nothing.
Task: Add an alt attribute describing the action (for example alt="Search") to each <input type="image"> in the evidence.

Constraints: make the smallest change that fixes this, keep the current design and behaviour, never paste secret values into code or chat, and tell me which files you changed.
Done when: Check with axe or a screen reader that each image button is announced with its action.

References