Skip to main content
UI Guides

Search rules

Search all UI Guides rules by name, category, or source

contentVercel

Icons Have Labels

MUST

MUST: Icon-only buttons have descriptive `aria-label`

Convey the same meaning with text for non-sighted users

Bad

Good

Why it matters

Icons aren't universally understood and are invisible to screen readers. Either show a visible text label alongside the icon, or provide an aria-label for icon-only buttons. The label should describe the action, not the icon itself.

References

Built by Gleb Stroganov, design engineer at Evil Martians.

The rules come from other people's skills and guidelines — Vercel, Rauno Freiberg, @Ibelick, impeccable, Emil Kowalski, Tailwind, RAMS — each one credited on the Sources page. The work here is extraction and wiring: every rule is pulled into one corpus, given a good and a bad example you can operate, a MUST/SHOULD/NEVER rule an agent can paste, and a link back to where it came from.