Alt text strategy: describe purpose, not pixels.

The guidance#

Meaningful images: descriptive alt. Decorative: alt="". Complex charts: alt summary + data table. Icons in buttons: aria-label on the button. Implement with object-cover slots that force alt discipline in review.

In markup#

html
<img class="w-full rounded-xl object-cover aspect-video" src="team.jpg" alt="The RRC Development team at the Dhaka office, 2026" />

Checklist#

  • Tested with keyboard only
  • Screen-reader spot check
  • Contrast verified for new pairs
  • Reduced-motion behavior confirmed
  • Zoomed to 200% without loss

accessibility/index|Accessibility hub · utilities/interactivity/sr-only|sr-only