WCAG reference → 4.1.2
4.1.2 Name, Role, Value (level A)
Interface components need a name, a role and a value that assistive technology can determine.
How it shows up in Confluence
Most of this belongs to Atlassian. What an author controls is the naming of the components they insert: a collapsible section with no title is a button with no name, an embed with no title is a frame with no name, and a link wrapping an image with no alt text is a link with no name.
What to do about it
Name every expand, embed and image-only link. If you cannot say what it is in three words, that is usually a sign the component is doing too much.
What Clearwren checks for this criterion
- Link has no readable text — A link with no text is announced only as its URL, or skipped entirely.
- Collapsible section has no label — An unlabelled expand is announced only as a button, so a keyboard user cannot tell what opening it will reveal.
- Embedded content has no accessible name — Embedded frames are announced by their title; without one, a screen-reader user hears only "frame".