Scrum Board | Development: Inappropriate heading structure

XMLWordPrintable

    • Minor
    • Accessibility

      Issue Summary

      The texts "Key metrics" and "Related work" have an inappropriate heading structure.

      Steps to Reproduce

      1. Open the Jira Cloud home page.
      2. Select any Scrum project and navigate to Space navigation.
      3. Navigate to the "Development" tab and activate it.
      4. Navigate through the page using the down arrow (JAWS/NVDA) and VO+Left arrow/Right arrow (VoiceOver).
      5. Observe that the mentioned headings have incorrect heading markup as per visual hierarchy.

      Screenshot

      Actual Results

      The heading structure is found to be inappropriate on the page. The text such as "Key metrics" and "Related work" is coded as <h4> instead of <h3>, which does not match the visual hierarchy on the page.

      As a result, screen reader users found it difficult to understand the page's content structure.

      Expected Results

      The heading levels should be announced as per the visual hierarchy by screen reader to understand the page structure for their users. Use heading levels as per specification such as <h1> should be followed by <h2>, <h3> and so on.

      In this scenario, mark the texts "Key metrics" and "Related work" as level 3 headings.

      Code Snippet:

      <h3 class="...">Key metrics</h3> 
      ...
      <h3 class="...">Related work</h3>

      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.5
      Windows - 11 pro
      Chrome - Version 148.0.7778.97 (Official Build) (arm64)
      Safari - Version 26.5 (21624.2.5.11.4)
      JAWS - Version 2026
      NVDA - Version 2024.4.2.35031
      Voiceover - Version Latestv

              Assignee:
              Unassigned
              Reporter:
              Anusooya .
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Created:
                Updated: