Back to Docs

Accessibility

The WCAG AA checklist every page has to pass.

This is the guide the PageHub MCP server gives an AI agent for get_style_reference({ topic: "accessibility" }). Names like set_theme are its tools (connect one), and the liquid topic is the HTML + Liquid reference.

Every page has to meet WCAG 2.1 AA:

  • Every image has alt ("" if decorative; aria-hidden="true" on decorative icons and overlays).
  • Sequential headings, exactly one h1 per page.
  • Every form input has a <label>, and autocomplete on personal-data fields.
  • Icon-only buttons still need an accessible name (aria-label or visible text).
  • 4.5:1 contrast on body text, 3:1 on large text.
  • Semantic elements: header, nav, main, section, footer.
  • Run audit_accessibility before you call the build done, and fix everything critical or serious.