Accessibility Remediation: How to Fix WCAG Issues on Your Website

An accessibility audit tells you what's broken. Remediation is how you fix it. Learn the process, how to prioritize, who fixes what, and how to prevent new issues.

93% Student Satisfaction (2K ratings)

Quantity Discounts

Price per course

6 to 20 courses

$20.95

21 to 50 courses

$17.95

51 to 200 courses

$13.95

201+ courses

Custom offer

An accessibility audit tells you what is wrong. Remediation is the work of fixing it. For most organizations, this is where compliance effort is concentrated β€” the audit takes days, but remediation takes weeks or months depending on the volume of issues and the complexity of the fixes involved.

This page covers the remediation process from start to finish: how to prioritize findings from an audit report, who should own each type of fix, how to handle the most common WCAG failures technically, how to prevent new issues from being introduced after remediation, and how to document your work for compliance purposes.

πŸ—ΊοΈοΈ

The Remediation Process: Five Phases

accessibility-fix-implementation

Effective remediation follows a structured sequence. Organizations that try to fix everything simultaneously typically make slower progress and introduce new issues. Working phase by phase, in severity order, is faster and more reliable.

1
Triage
Days 1–2 Β· Accessibility lead + project manager

Before anyone writes a line of code, work through the audit report and classify every finding by severity and by who owns the fix. This prevents remediation effort from being misdirected and ensures Critical issues are addressed first.

  • β†’ Group all Critical findings β€” these block task completion for users with disabilities and must be addressed first
  • β†’ Group Serious findings β€” these significantly impair access and should follow immediately after Criticals
  • β†’ Identify all template-level issues β€” issues that appear on many pages because of a shared component; one fix resolves all instances
  • β†’ Assign each finding to its owner: developer (code), designer (colour, focus indicators), content editor (alt text, link text, headings), document owner (PDFs)
2
Critical and Serious fixes
Weeks 1–2 Β· Development team + content editors

Address all Critical and Serious findings in the audit report. For most sites, this represents the issues that most significantly affect real users. Complete this phase before moving to Moderate issues.

  • β†’ Fix all keyboard navigation failures β€” menus, modals, forms, and interactive components that cannot be operated without a mouse
  • β†’ Fix missing alt text on all meaningful images on high-traffic pages
  • β†’ Fix colour contrast failures on text across all key pages
  • β†’ Fix form label and error message issues
  • β†’ Fix missing captions on all videos
  • β†’ Retest each fix after implementation β€” confirm the specific issue is resolved and no new issues introduced
3
Moderate and Minor fixes
Weeks 3–4  Β·  Development team + content editors

Work through Moderate and Minor findings. These have lower individual impact but can accumulate to create a poor overall experience. Template-level Moderate fixes are high-priority within this phase.

  • β†’ Fix heading structure issues across page templates
  • β†’ Fix vague link text β€” all "Read more" and "Click here" instances
  • β†’ Add skip navigation links where missing
  • β†’ Fix focus indicator visibility on remaining interactive elements
  • β†’ Remediate PDF documents or provide accessible alternative formats
  • β†’ Fix page language declaration issues
4
Retest and document
Week 5  Β·  Accessibility specialist + project manager

After remediation is complete, retest the fixed pages to confirm issues are resolved correctly. Document the results. This retest report is your compliance evidence.

  • β†’ Retest all Critical and Serious findings using the same methodology as the original audit
  • β†’ Verify that template-level fixes have resolved all instances across the site
  • β†’ Document pass/fail status for each original finding
  • β†’ Produce a retest report showing original issues and their resolution status
  • β†’ Flag any issues that were only partially resolved or introduced new failures
5
Process integration
Ongoing  Β·  Development lead + content lead

Remediation fixes existing problems. Without process changes, new issues accumulate at the same rate as old ones are fixed. Integrate accessibility into your development and content workflows so new work starts accessible.

  • β†’ Add automated accessibility checks (axe DevTools) to the development QA process
  • β†’ Integrate axe-core into your CI/CD pipeline so checks run on every pull request
  • β†’ Add accessibility review to content publishing checklists
  • β†’ Brief content editors on alt text, heading structure, and link text requirements
  • β†’ Agree accessible design standards for new components and page templates
  • β†’ Schedule periodic re-audits β€” annually for active sites, or after major redesigns
πŸ“Š

How to Prioritize: Severity First, Template Issues Second

The audit report assigns a severity rating to each finding. Use severity as your primary ordering principle β€” not page location or issue type.

Severity Definition Remediation priority Example
Critical Prevents task completion. No workaround available. Fix before next deployment Checkout button cannot be reached by keyboard. Blind users and keyboard users cannot purchase.
Serious Significantly impairs access. Workaround may exist but not obvious. Fix within 2 weeks Dropdown nav reachable by keyboard but items cannot be selected without a mouse.
Moderate Causes difficulty but most users can still complete the task. Fix within 4–6 weeks Form placeholder text is the only label. Disappears on input. Difficult but not impossible to complete.
Minor Technical failure with low real-world impact. Backlog β€” normal development cycle Decorative image alt text could be improved but does not prevent information access.
Template issues: fix once, resolve everywhere
Β 
If an issue appears on 80 pages because every page uses the same navigation template, fixing the template resolves all 80 instances in one change. Always identify template-level issues in triage and fix them before page-specific issues β€” the return on effort is much higher.
πŸ‘₯

Who Fixes What: Routing Issues to the Right Owner

accessibility-remediation-workflow

Accessibility remediation crosses multiple teams. Routing each finding to the right owner prevents bottlenecks where everything waits for a developer when many issues are content or design changes.

Issue type Who fixes it What the fix involves
Missing or poor alt text on images Content editor / digital marketing Write accurate, purposeful alt text for each affected image. Update in CMS. Train to prevent recurrence.
Colour contrast failures Designer + front-end developer Designer updates colour palette to meet minimum ratios. Developer updates CSS. May require design system changes.
Missing form labels Front-end developer Add <label for=""> elements or aria-label attributes. Verify each field has a persistent visible label.
Keyboard navigation failures Front-end developer Rebuild components to be keyboard-operable. Fix focus management in modals and dropdowns. Test with keyboard and NVDA.
Missing video captions Content team / video producer Produce accurate captions (human-reviewed). Upload as .vtt or .srt subtitle files. Do not rely on auto-generated captions alone.
ARIA errors on custom components Front-end developer Add correct ARIA roles, properties, and states. Test with screen reader to confirm announcements are correct.
Vague link text Content editor Rewrite link text to describe the destination: "Read more" β†’ "Read the AODA compliance guide". Update in CMS.
Heading structure issues Content editor Correct heading hierarchy using CMS heading styles. Never use bold text as a substitute for heading markup.
Inaccessible PDFs Document owner + accessibility specialist Remediate PDF tagging in Adobe Acrobat or InDesign, or replace the PDF with an accessible HTML alternative.
Missing skip navigation Front-end developer Add a visually hidden skip link at the top of the page template. Confirm it appears on keyboard focus and works correctly.
πŸ’»οΈ

Technical Fix Guidance: The Most Common WCAG Failures

Here is specific technical guidance for the issues that appear most frequently in WCAG remediation projects. Each card shows the issue, the WCAG criterion, the fix, and what the code should look like before and after.

WCAG 1.1.1 Missing or empty alt text Critical / Serious

Add an alt attribute to every img element. For images that convey information, describe the purpose (not just the appearance). For decorative images, use alt="".

βœ— Before
<img src="chart.png">
βœ“ After
<img src="chart.png" alt="Bar chart:
Q4 revenue up 12% year-on-year">
WCAG 1.4.3 Colour contrast failure Serious

Increase contrast between text colour and background to at least 4.5:1 for body text, 3:1 for large text. Use the Colour Contrast Analyser to verify ratios before and after.

βœ— Before β€” ratio: 2.85:1 FAILS
color: #999999;
background: #ffffff;
βœ“ After β€” ratio: 7.0:1 PASSES
color: #595959;
background: #ffffff;
WCAG 3.3.2 Missing form label Serious

Associate every form field with a visible <label> element using a matching for/id pair. The label must persist visibly β€” placeholder text alone does not satisfy this criterion.

βœ— Before
<input type="email"
  placeholder="Enter email">
βœ“ After
<label for="email">
  Email address
</label>
<input type="email" id="email">
WCAG 2.1.1 / 2.1.2 Keyboard trap / inaccessible modal Critical

When a modal opens, move focus into the modal. Trap focus inside the modal while it is open (Tab cycles through modal elements only). When the modal closes, return focus to the trigger element.

βœ— Before
Modal opens but focus stays on
the page behind it. Tab navigates
background. Escape does not close.
βœ“ After
On open: focus β†’ first modal element.
Tab/Shift+Tab cycles within modal.
Escape closes + returns focus to trigger.
WCAG 2.4.7 Missing focus indicator Serious

Remove outline: none / outline: 0 from CSS, or replace it with a clearly visible custom focus style. The focus indicator must have at least 3:1 contrast ratio against adjacent colours.

βœ— Before β€” removes all focus visibility
a:focus, button:focus {
  outline: none;
}
βœ“ After β€” PASSES
a:focus, button:focus {
  outline: 2px solid #185FA5;
  outline-offset: 2px;
}
WCAG 4.1.2 Custom component without ARIA Critical / Serious

Add ARIA role, state, and label to custom interactive components. Test with NVDA and VoiceOver to confirm screen reader announces the component correctly and reflects state changes.

βœ— Before
<div class="toggle"
  onclick="toggle()">
  Enable notifications
</div>
βœ“ After
<button role="switch"
  aria-checked="false"
  onclick="toggle(this)">
  Enable notifications
</button>
πŸ›‘οΈοΈ

Preventing New Issues After Remediation

Remediation fixes what is already broken. Without process changes, new accessibility issues will be introduced with every content update, new feature, and design change. The goal after remediation is to make accessibility the default β€” not an afterthought.

πŸ’»
In the development workflow
  • β†’ Add axe DevTools to the browser development environment β€” run it before marking any ticket as done
  • β†’ Integrate axe-core into your CI/CD pipeline so automated checks run on every pull request
  • β†’ Create a component library of accessible, tested UI patterns
  • β†’ Add accessibility criteria to your definition of done
🎨
In the design workflow
  • β†’ Check colour contrast of every colour decision before handoff using Figma plugins or the Colour Contrast Analyser
  • β†’ Design visible focus states for every interactive component β€” include them in design specifications
  • β†’ Annotate designs with expected ARIA roles and keyboard behaviour for custom components
✍️
In the content workflow
  • β†’ Add an accessibility checklist to your content publishing process: alt text added, heading styles used, link text is descriptive
  • β†’ Train content editors on the three most impactful practices: alt text, headings, and link text
  • β†’ Set a policy that videos are not published without reviewed captions
πŸ“‘
Ongoing monitoring
  • β†’ Schedule automated scanning β€” weekly or monthly using axe or WAVE across key pages
  • β†’ Full manual re-audit every 1–2 years for active sites
  • β†’ Trigger re-audit after any major redesign or CMS migration
πŸ—‚οΈ

Documenting Remediation for Compliance Purposes

common-accessibility-issues-fixed

For AODA compliance purposes β€” particularly if your organization needs to file a compliance report or respond to a complaint β€” documentation of remediation progress is as important as the remediation itself.

What to document during remediation
βœ“
The original audit report β€” the baseline record of issues found
βœ“
Triage decisions: which issues were prioritized, why, and who owns each fix
βœ“
Remediation log: issue ID, fix description, developer/editor responsible, date completed
βœ“
Retest results: confirmation that each fix was verified after implementation
βœ“
The final retest report β€” your evidence that identified issues have been resolved
βœ“
Any issues not yet resolved β€” documented with rationale and planned resolution date
Documentation demonstrates good-faith effort
Β 
An organization that identified accessibility issues through an audit and documented its remediation process is in a significantly stronger position than one that has no evidence of any compliance activity β€” even if remediation is not yet 100% complete.
❓

Frequently asked questions

How long does accessibility remediation take?
  • For a small website (up to 20 pages) with typical findings, Critical and Serious issues can usually be addressed in two to four weeks of developer and content team time. A full remediation pass including Moderate and Minor issues typically takes four to eight weeks. For larger or more complex sites, the timeline scales with page count, template complexity, and the volume of PDF documents. Starting with Critical issues on high-traffic pages delivers the most user impact in the least time.
  • Many WCAG issues can be fixed by your existing development and content teams without specialist involvement β€” provided the audit report is specific enough to guide the fix. Content fixes (alt text, headings, link text) require no specialist knowledge, just training and discipline. Code fixes (ARIA, keyboard navigation, focus management) require front-end development skill. Complex issues like custom widget ARIA patterns or PDF remediation may benefit from specialist involvement, particularly for retesting to confirm correct implementation.
  • Address Critical and Serious issues first β€” the ones that prevent users with disabilities from completing core tasks. Document your remediation plan and timeline. For AODA compliance purposes, a phased remediation plan with documented progress is significantly better than no plan at all. Organizations with large volumes of issues typically take a phased approach over several months, prioritizing by user impact.
  • Yes, always. It is common for a code change to fix one WCAG criterion while inadvertently introducing another issue. Retesting each fix before moving on catches these secondary failures early. For compliance documentation purposes, retest results are essential β€” they are the evidence that remediation actually worked, not just that work was done.
  • Remediation means fixing the underlying code and content of your website so it genuinely meets WCAG 2.0 Level AA. An accessibility overlay is a JavaScript plugin that attempts to fix accessibility issues automatically by adding a layer on top of your existing code. Overlays do not produce genuine WCAG compliance, have been widely rejected by accessibility specialists and disabled users, and do not protect your organization from AODA enforcement. Genuine remediation is the only approach that works.

Get Professional Help with Your Remediation

Whether you need a developer to implement specific fixes, a specialist to guide your team through complex ARIA patterns, or a complete remediation engagement with retesting β€” our accessibility team works with your development and content teams to resolve audit findings correctly.