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

Unnamed Nested Element

Nested Android elements that carry meaningful content must have their own accessible name rather than inheriting an ambiguous or empty label from a parent container.

WCAG Reference

Maps to: WCAG 4.1.2 Name, Role, Value | Applies to: WCAG 2.0, WCAG 2.1, WCAG 2.2 Introduced in: WCAG 2.0 | Level: A | Read the official specification →

What this rule checks​

The scanner identifies nested views (images, icons, text) inside a focusable parent container that do not have their own accessible label, causing their meaning to be lost in TalkBack's aggregated announcement of the parent.

Why it matters​

When a focusable container aggregates all child text into a single announcement, individual elements lose context. Users cannot distinguish between a product image, a price label, and an add-to-cart button if they are all merged into one announcement.

Common failure patterns​

  • image icons inside a clickable row with no individual contentDescription
  • status badges (unread count, priority indicator) that are visually meaningful but unnamed
  • grouped elements where only the parent has an accessible name, hiding the details of children

Remediation guidance​

  • add contentDescription to each meaningful child element within a group
  • if the parent should aggregate children, compose the parent's contentDescription to include all relevant child information
  • use android:importantForAccessibility="no" only on truly decorative children
  • test with TalkBack at different granularity levels (character, word, element) to confirm all meaningful content is announced

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