Header | Search: Dynamic search result message is not exposed to screen readers

XMLWordPrintable

    • Severity 3 - Minor
    • Accessibility

      Issue Summary

      The message “We couldn't find any results with that title” is not announced to screen reader users.

      Steps to Reproduce

      1. Open the Confluence Cloud Homepage.
      2. Using a screen reader, navigate to the “Search” field and enter a search term that returns no results.
      3. Observe that a message appears automatically on the page but is not announced by the screen reader.

      Screen Recording

      Search Message Issue

      Actual Results

      When a user enters a search term in the "Search" field that returns no results, a message appears on the page stating, “We couldn't find any results with that title”. However, this message is not announced to screen reader users. Because the message is dynamically rendered and is not programmatically exposed (e.g., via an ARIA live region), screen reader users are not informed that the search has returned no results. As a result, screen reader users are not aware that the message is displayed on the page.

      Expected Results

      The screen reader should announce dynamically added message to users.

      Use ARIA live region to make sure that the dynamic update is announced for screen reader users. This can be achieved by either adding a live region role="status" or  aria-live="polite" and aria-atomic="true" attributes to the container used to display the message. Make sure the live region is present in the page source by default.

      For more information on implementing the live regions, visit https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Live_Regions

      Code Snippet:

      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.

      <span aria-live="polite" role="status">
      We couldn't find any results with that title
      </span>

       

      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 Tahoe 26.2
      Operations - Windows11
      Chrome - Version 144.0.7559.133 (Official Build) (64-bit)
      Safari- Version 26.2
      JAWS- Version 2023
      NVDA- Version 2025.3.2
      VoiceOver - Version Latest

              Assignee:
              Unassigned
              Reporter:
              Chirag Goyal
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: