Guide
Fixing accessibility findings
What contrast, alt text, label, and landmark findings mean, and how to resolve them.
5 min read
Start with contrast failures
Colour contrast is measured in a real browser against WCAG 2.1 AA: 4.5:1 for normal text, 3:1 for large text. The finding includes a screenshot with each failure highlighted, plus the exact foreground and background colours measured. Adjust whichever is easier in your design system.
Write useful alt text
Every informative image needs a concise alt attribute describing its purpose, not its appearance. Decorative images should use an empty alt (alt="") so screen readers skip them. The finding lists each image URL missing alt text, exportable to CSV for handoff.
Label forms and links
Form fields need an associated label element, aria-label, or aria-labelledby. Links and buttons need text content or an accessible name. Icon-only buttons are the usual offenders. The per-page details list every unlabeled element found.
Fix heading and landmark structure
Pages should have one H1, headings that descend without skipping levels, and semantic landmarks (header, main, nav, footer). These give screen reader users a navigable outline of the page.