-
Type:
Bug
-
Resolution: Unresolved
-
Priority:
Low
-
None
-
Affects Version/s: 8.6.0, 9.2.10, 10.2.6
-
Component/s: Editor - Attachment
-
None
-
Severity 3 - Minor
Issue Summary
From Confluence 8.6.0 onward, Image caption is rendered as aria-label on <img>, which overrides the alt attribute and effectively cancels the Alt text for screen readers. Earlier versions (8.5.x) used title instead and did not override alt.
Environment
- Not affected: Confluence 8.5.23 (Image title → title, Alt text → alt)
- Affected:
- Confluence 8.6.0
- Confluence 9.2.10
- Confluence 10.2.6
- Change introduced with: Confluence 8.6 Release Notes
Steps to Reproduce
- Log in to Confluence 8.6.0+.
- Create or edit a page.
- Insert an image (attachment) into the page.
- Open Image Properties:
- Set Alt text to e.g. My Altz.
- Set Image caption to a different value, e.g. My Captionz.
- Publish the page.
6. In View mode, inspect the HTML for the <img> element of that image.

Observed HTML in 8.6.0+ (and 9.2.10, 10.2.6, etc.):
<img class="confluence-embedded-image" draggable="false" alt="My Altz" ... aria-label="My Captionz">
- Image caption → rendered as aria-label
- Alt text → rendered as alt
Observed HTML in 8.5.23:
<img class="confluence-embedded-image" draggable="false" alt="My Altz" ... title="My Titlez">
- Title text → rendered as title
- Alt text → rendered as alt
Expected Results
- The Alt text (alt) should remain the primary accessible name for the image.
- Adding an Image caption should not override the alt attribute as the accessible name.
Actual Results
- When Image caption is set, Confluence writes it to aria-label on the <img>.
- This means screen readers will read the caption text instead of the Alt text, effectively cancelling the Alt text and potentially breaking accessibility expectations.
Workaround
Currently there is no known workaround for this behavior. A workaround will be added here when available