For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content

VoiceOver on macOS

Use this page as the macOS-specific reference for VoiceOver when validating Safari or Chrome experiences after automated Accessibility findings.

When to use this​

Use VoiceOver on macOS when your team needs to understand how desktop macOS users experience navigation, labels, landmarks, and interactive content.

Onboarding: enable VoiceOver and browse the web​

  1. Open System Settings → Accessibility → VoiceOver (names vary slightly by macOS version) and turn VoiceOver On, or press Command + F5.
  2. Accept the quick-start tutorial the first time. It teaches the VO modifier (Control + Option by default).
  3. Open Safari, load your URL, and use VO + Right Arrow to move by rotor setting (start with DOM or auto mode for web).
  4. Practice the rotor (VO + U) to jump by headings, links, or form controls.
  5. Use Tab and Shift+Tab alongside VoiceOver to confirm focus order matches visual order.

What to validate​

  • heading and landmark structure
  • control names and hints
  • form labels and error messaging
  • keyboard and screen-reader navigation consistency

20-minute smoke checklist​

StepAction
1Landmarks: VO + U → Landmarks; ensure main/nav are sensible.
2Headings: navigate by headings; levels should not skip arbitrarily.
3Buttons/links: every interactive element speaks a name (not just “button”).
4Forms: errors associate with fields; required state is announced.
Last updated on

Terminal First Testing With Kane CLI

Natural language browser & mobile app tests right from terminal.

×
Schedule Your Personal Demo
Kane CLI terminal

Help and Support

Related Articles