Purpose
When you attach a mitigation & remediation plan to a VPAT (Voluntary Product Accessibility Template), reviewers look for three things:
- What's wrong
- How bad it is (user impact)
- What we'll do and when
Severity | Definition (user impact) | Typical WCAG failures | Timelines | Typical Interim Accommodation |
---|---|---|---|---|
Critical / Blocker | User cannot complete a core task with assistive tech. |
|
≤ 30 calendar days (hot-fix or emergency release). | Rarely feasible—must ship fix. |
High | Major difficulty or confusion; task possible but with workarounds. |
|
≤ 60 calendar days (included in next scheduled release). | Alternate workflow (phone / accessible PDF) documented. |
Moderate | Causes friction; practical workaround exists. |
|
≤ 120 calendar days (quarterly release). | Documented workaround or guidance provided. |
Low / Cosmetic | Annoyance that does not block understanding. |
|
When touched (no later than 1 year or the next major UI refresh). | None required. |
ID | Page/View | Issue Summary | Severity | Status | Fix Target Date |
---|---|---|---|---|---|
ACC-001 | /login | Screen reader does not announce login error message | High | Open | 2025-06-10 |
ACC-002 | /dashboard | Chart colors lack sufficient contrast | Moderate | In Progress | 2025-08-01 |
ACC-003 | /profile/settings | Keyboard focus is not visible on save button | Critical | Open | 2025-05-30 |
ACC-004 | /search | Search field lacks associated label | High | Fixed | 2025-05-12 |
ACC-005 | /terms | PDF download link lacks accessible description | Low | Deferred | 2026-01-01 |
Guidelines
- IDs never change once issued.
- Include exact screen/node so QA can retest quickly.
- Link each row to its Jira ticket (e.g., ABC-123).
Stage | Time Window | Deliverables / Actions |
---|---|---|
Triage | 0-15 days |
- Severity confirmed - Owner Assigned - Jira ticket created |
Design & Development | 15-60 days | Fix implemented behind feature flag |
QA / AT Validation | 60-75 days | Manual SR + keyboard tests, automated regression |
Release | ≤ 90 days | Fix live, VPAT updated |
4. Interim accommodations
Describe how an affected user can obtain equivalent access until the permanent fix is live (alternate HTML page, accessible PDF, phone line, etc.).
5. Review Cadence
This plan is reviewed quarterly. Resolved items move to the main VPAT; new findings are added within 30 days of discovery.
6. Plain-Language Principle
Avoid developer jargon; write so procurement, legal, and auditors can follow without technical context.
Best-Practice Checklist
- Severity reflects user impact
- Each row maps to WCAG success criterion + unique ID
- Owner & target date committed
- Interim workaround documented for Moderate or higher
- Review cycle stated
- Document stored alongside code backlog for traceability
UAT/Release Testing or Other
If an agency finds a defect during UAT, Phased Release Testing or some other random occurrence, we need to be prepared. Give the agency a structured spreadsheet (or form) to log any defects they discover. It shows we're prepared to ingest findings quickly and fold them into the same workflow we use for internally discovered issues.
A few tips to make that hand-off run smoothly:
- Match your internal fields
Use the same columns you have in your Confluence tracker—ID, WCAG SC, description, severity, steps to reproduce, screen / component, date found, reporter, and optional screenshots. When you import the file, there's no re-mapping or data loss. - Provide guidance on severity
Like in this document, see above. - Acknowledge receipt
When the agency returns the sheet, reply with a quick “All issues loaded as tickets XYZ-123-XYZ-130; you'll see them reflected on the Confluence page within 24 hours.” That closes the loop and builds trust. - Update the VPAT & plan
Once each external issue is triaged, update the severity/timeline table in Confluence so the VPAT addendum stays the single source of truth.
Timelines for accessibility issues and their response
Spell out clear response expectations up-front. Without them, defects can linger in email threads and throw off your own remediation schedule.
Phase | Who acts | Recommended window | Rationale |
---|---|---|---|
Discovery → Submission | Agency testers | ≤ 2 business days after the defect is observed | Gives testers time to capture reproduction steps and screenshots but keeps feedback fresh. |
Submission → Acknowledgment | Your team | 1 business day | Confirms receipt, assigns internal ticket number, and communicates severity. |
Acknowledgment → Triage> | Accessibility lead / product owner | 3 business days | Validates the issue, sets severity, and enters the fix window listed in your plan. |
Tips for making it stick
- Include the timeline in the SOW or test plan. Write it as an acceptance criterion so everyone signs off.
- Be flexible for blockers. If testers find a Critical issue that stops UAT, allow same-day escalation outside the normal window.
- Review after each cycle. If the business/agency/customer consistently meets (or misses) the timeline, adjust the window or resources next sprint.