Guides › Accessibility
18 guides

Accessibility fix guides

Step-by-step guides to fix every Accessibility issue a website audit can find — with code you can copy, platform notes and how to check the fix worked.

How to Fix Colour Contrast Errors (WCAG 1.4.3)Fix low colour contrast flagged by axe and Lighthouse: find failing text, pick colours that reach 4.5:1 (3:1 for large text), update CSS tokens and retest.How to Fix Missing Image Alt Text for AccessibilityFix images, SVGs, image buttons, image maps and embeds that have no text alternative, so screen reader users and search engines understand your visuals.How to Fix Form Fields Missing Labels for AccessibilityFix unlabeled inputs, selects and textareas flagged by accessibility audits. Connect a visible label to each field so screen readers and autofill work.How to Fix Buttons Without Accessible Names on Your SiteIcon-only and empty buttons are announced as just "button" to screen reader users. Learn to add visible text or aria-labels so every button says what it does.How to Fix Links Without Discernible Text on Your SiteFix the "links must have discernible text" accessibility error: find empty icon and image links, add text, alt or aria-label, and verify with axe or Lighthouse.How to Fix a Missing or Invalid Page Language (html lang)Add a valid lang attribute to your <html> tag and inline elements so screen readers pronounce content correctly. Fixes for HTML, WordPress, Shopify, Next.js.How to Fix a Missing or Empty Page Title ElementFix the missing or empty <title> accessibility error: add a unique, descriptive title to every page so screen readers, search results and tabs name it.How to Fix Heading Order: One H1 and No Skipped LevelsFix skipped heading levels, a missing H1 and empty headings so screen readers and search engines see a clear outline. Includes a console snippet and platform notes.How to Fix a Missing Main Landmark and Unwrapped ContentFix the 'Main landmark present' audit: add exactly one <main> element, place all other content in header, nav, aside and footer landmarks, and retest the page.How to Add a Skip to Content Link for Keyboard UsersFix the missing skip link audit warning: add a "Skip to content" link that targets your main content, hide it until focused, and confirm it works with Tab.How to Fix Invalid ARIA Attributes and Roles on Your SiteFix invalid ARIA roles, misspelled or disallowed aria-* attributes and missing required states so screen readers and audit tools read your widgets correctly.How to Fix Duplicate Element IDs for AccessibilityFind and fix duplicate id attributes, especially those used by ARIA, labels and focusable elements, so screen readers announce the right labels and controls.How to Fix List Structure Errors in HTML (ul, ol, dl)Fix 'lists structured correctly' accessibility errors: keep only <li> inside <ul>/<ol>, dt/dd inside <dl>, so screen readers announce lists properly.How to Fix "Frames Have Titles": Add Iframe Title AttributesFix the 'Frames have titles' accessibility check: give every iframe a unique, descriptive title so screen reader users know what each embed contains.How to Fix "Zooming Disabled" in the Viewport Meta TagRemove user-scalable=no and maximum-scale from your viewport meta tag so visitors can pinch-zoom up to 500%, and pass the axe and Lighthouse zoom checks.How to Fix Positive tabindex Values for Keyboard UsersFind and remove tabindex values above 0 so keyboard focus follows your page's visual order. Step-by-step fix for HTML, WordPress, Shopify and React sites.How to Fix Missing Video Captions on Your WebsiteFix the missing video captions accessibility issue: create WebVTT files, add <track kind="captions"> to every <video>, add audio transcripts, and verify with axe.How to Fix WCAG 2.2 AA Accessibility Violations on Your SiteFind and fix WCAG 2.2 AA violations with axe: missing alt text, low contrast, unlabeled forms, empty buttons and small targets, prioritized by severity.

What do Accessibility fix guides cover?

Accessibility guides fix WCAG 2.2 AA issues found by axe-core in a real browser: colour contrast, alt text, form labels, button and link names, headings, landmarks, zoom, keyboard focus and video captions. Each guide shows the HTML or CSS change and how to test it with a screen reader or keyboard.

How to use these guides

Run an audit first so you know which of these issues affect your site, then open the guide linked from each issue in your report. Every guide lists what you need, the steps in order, code for common platforms and how to confirm the fix worked. After fixing, click Re-check on the issue to verify it in seconds.

Which of these affect your site? Run a free audit — ZORO finds the Accessibility issues on your pages and links to the right guide.

Run a free audit