[DOCS] Screen reader accessibility docs still say permission mode changes are not announced

Open 💬 0 comments Opened Jul 15, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/accessibility

Section/Topic

The Known limitations section's description of permission mode changes in screen reader mode. The permission-mode cycling guidance in the permission modes and interactive mode references should also be kept consistent.

Current Documentation

The accessibility page currently lists this as a limitation:

Some behaviors aren't adapted for screen reader mode: * Mode changes, such as entering plan mode, aren't announced yet.

The same page describes permission prompts as accessible numbered menus, but does not describe any spoken feedback when the user cycles modes. The permission modes page only says:

During a session: press Shift+Tab to cycle defaultacceptEditsplan. The current mode appears in the status bar.

What's Wrong or Missing?

Claude Code v2.1.210 now announces permission mode changes aloud in screen reader mode when the user cycles modes with Shift+Tab. The accessibility page still says that mode changes are not announced, so it contradicts the current behavior and tells screen-reader users that an important accessibility feature is unavailable.

The cycling instructions also describe the visual status-bar indicator without explaining the spoken mode-change feedback. A screen-reader user can therefore miss that the active permission mode changed or continue relying on the outdated limitation.

Suggested Improvement

Remove or replace the outdated limitation in the Known limitations section. Add a versioned note stating that, as of Claude Code v2.1.210, screen reader mode announces the selected permission mode when Shift+Tab cycles through modes. Clarify that the announcement applies to interactive CLI mode switching.

Update the permission modes and interactive mode references to cross-link the accessibility guidance and mention that screen reader users hear the mode change while cycling, in addition to seeing the mode in the status bar when visual rendering is available.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/accessibility | Known limitation incorrectly says permission mode changes are not announced |
| https://code.claude.com/docs/en/permission-modes | CLI Shift+Tab mode-cycle instructions describe only the visual status bar |
| https://code.claude.com/docs/en/interactive-mode | Keyboard shortcut reference says Shift+Tab cycles modes without accessibility-specific feedback |

Total scope: 3 pages affected by the same outdated or incomplete description of screen-reader feedback for permission-mode cycling.

The behavior change was introduced in Claude Code v2.1.210.

View original on GitHub ↗