View Page | Comments: Headings not defined

XMLWordPrintable

    • Severity 3 - Minor
    • Accessibility

      Issue Summary

      The "Comments" section is not semantically declared as heading.

      Steps to Reproduce

      1. Open the Confluence home page.
      2. Create a new page or open an existing page.
      3. Publish the page if it is not already published.
      4. Scroll to the bottom of the page and activate the “Add a comment” control, then add a comment.
      5. After saving the comment, the "Comments" section appears at the bottom of the page.
      6. With a screen reader, navigate to the “Comments" section using the down arrow (JAWS/NVDA) and VO+Left arrow/Right arrow (VoiceOver).
      7. Observe that the screen reader announces "Comments" as plain text, not as heading.
      8. Inspect the code for the “Comments” text and note that it is not marked up with heading semantics.

      Screenshot

      Actual Results

      The “Comments” text on the page is not semantically declared as a heading. Although it is visually presented as a distinct section, it is rendered as normal text using a <span> element rather than using heading semantics.

      As a result, screen reader users cannot navigate to the “Comments” using heading shortcuts.

      Expected Results

      Screen reader should identify the text as a heading for their users. 

      In this case, mark up the "Comments" as heading level 2, using an appropriate HTML headings. In addition, use heading levels as per specification such as <h1> should be followed by <h2>, <h3> and so on.

      Code Snippet:

      <h2 class="_11c81af2 _syazazsu _ect41oil _k48p1wq8">Comments</h2>

      Note:  This code example is intended only as a general illustration of how to address the violation and should not be considered a complete or production-ready solution. If you have any questions, please attach this ticket to a #help-accessibility request.

      Workaround

      Currently there is no known workaround for this behavior. A workaround will be added here when available.

      Environment

      MacBook Pro (16 inch, 2021)
      macOs 26.2 (25C56)
      Windows - 11 pro
      Chrome - Version 144.0.7559.97 (Official Build) (arm64)
      Safari - Version 26.2 (21623.1.14.11.9)
      JAWS - Version 2025
      NVDA - Version 2024.4.2.35031
      Voiceover - Version Latest

              Assignee:
              Thomas Riley Gowan
              Reporter:
              Anusooya .
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Created:
                Updated:
                Resolved: