Image caption is rendered as aria-label on <img>, which overrides the alt attribute and effectively cancels the Alt text for screen readers.

XMLWordPrintable

    • 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:

      Steps to Reproduce

      1. Log in to Confluence 8.6.0+.
      2. Create or edit a page.
      3. Insert an image (attachment) into the page.
      4. Open Image Properties:
        • Set Alt text to e.g. My Altz.
        • Set Image caption to a different value, e.g. My Captionz.
      5. 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

              Assignee:
              Unassigned
              Reporter:
              Shruthi Hebbal
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Created:
                Updated: