obsidian/wiki/tech-patterns/payload-cms-admin-accessibility.md
2026-05-15 15:13:56 +01:00

1.9 KiB

title aliases tags sources created updated
Payload CMS — Admin Panel Accessibility
payload-accessibility
payload-a11y
payload-cms
accessibility
a11y
wcag
admin-panel
raw/admin__accessibility.md
2026-05-15 2026-05-15

Payload CMS — Admin Panel Accessibility

Payload's admin panel has an active accessibility program targeting WCAG 2.2 AA compliance.

Compliance Status

Standard Status Notes
WCAG 2.2 AA In Progress Actively working toward full compliance

Current status report: GitHub Discussion #14489

Testing Approach

  • Axe integrated into e2e test suites — automated long-term compliance checking
  • Custom utilities for keyboard navigation, window overflow, and focus indicator testing
  • Manual screen reader testing with assistive technologies

Key Takeaways

  • Payload is not yet fully WCAG 2.2 AA compliant — "in progress" as of 2026-05
  • Accessibility issues should be reported via the GitHub Discussion
  • Axe in e2e = regressions caught automatically; don't rely solely on manual testing
  • If building custom Payload UI components, test with keyboard nav and screen readers to match the panel's own approach
  • Focus indicators and keyboard navigation are explicitly tested — custom fields should follow the same standard

Sources