No Code Attached Yet a11y a11y-audit-backlog a11y-priority-moderate (Medium)
avatar mbeganyi-a11y
mbeganyi-a11y
7 Sep 2026

Steps to reproduce the issue

Milestone 1a finding ID M1a-027
Backlog priority Medium
Severity — carried from Milestone 1a Moderate
Implementation effort Medium
Target milestone(s) MS2b — Core Forms and Validation; MS3b — Backend Template Build
WCAG 2.2 success criterion 1.3.1 Info and Relationships
Responsibility tag(s) from report Development
Affected Joomla area/component Extensions Install from Web — search-results structure — Milestone 1a finding #27
Affected user journey(s) 07 — Installer Wizard (com_installer/Install)

Extensions Install from Web view showing category navigation on the left and extension search results on the right

Audit finding

The Install from Web view has no structure that identifies where search results begin.

The skip-link menu can focus on the Categories heading above the left-side navigation, but there is no equivalent way to move quickly to the search results.

Individual extension titles use <h4> elements, while the Categories heading uses <h3>. The report suggests adding a level-3 “Results” heading to clarify the page structure.

User impact

Screen-reader users cannot quickly navigate to the search results after submitting a search.

They may need to move through the category navigation or listen through the page to find the results. This makes searching for extensions slower and less predictable.

The heading hierarchy also does not clearly show that the extension titles belong to a results area. Users may not understand the relationship between the search, categories, and listed extensions.

Remediation plan

Provide a clear, navigable structure for search results

  • Add a translatable “Results” heading at the appropriate level, such as level 3, before the search results
  • Ensure the heading hierarchy reflects the relationship between the search area, categories, and results
  • Ensure extension titles use a heading level appropriate to the revised structure
  • Ensure the results heading is exposed to assistive technology and can be used for navigation
  • Consider whether a skip link or landmark is appropriate for reaching the results quickly
  • Preserve the existing search and category behaviour
  • Ensure the results area remains associated with the search that produced it
  • Verify the structure after a search returns results, no results, and a changed result count
  • Apply the corrected structure to the shared extension-browser component
  • Do not rely on visual position alone to identify the results area

Preconditions

  • Use Joomla 6.2 with the Atum administrator template
  • Sign in with an account permitted to access the Installer
  • Use a test installation where the Install from Web extension list is available
  • Use a search term that returns at least one result
  • Also prepare a search term that returns no results, if the interface supports that state
  • Record the exact Joomla build, browser name and version, operating system, viewport dimensions, and browser zoom
  • Record the screen reader and browser combination if testing announcements
  • Start at 100% browser zoom
  • Do not install an extension during verification

Steps to reproduce

  1. Open the Joomla administrator interface at the site's base URL followed by /administrator/
  2. Open System → Install → Extensions
    • Alternatively, navigate to /administrator/index.php?option=com_installer on the same installation
    • Record the navigation labels if they differ in the tested build
  3. Open the Install from Web extension list
  4. Enter a search term that returns at least one result
  5. Submit the search
  6. Inspect the results area using Developer Tools
  7. Record whether a heading or other structure identifies the results
  8. Record the heading levels used for Categories, search results, and individual extensions
  9. Check whether a skip link or landmark can move focus to the results
  10. Use a screen reader to navigate by headings
  11. Record whether a “Results” heading is available
  12. Record the announced heading hierarchy and extension titles
  13. Repeat with a search that returns no results
  14. Record whether the no-results state is structurally identifiable
  15. Capture the search term, results area, heading structure, and navigation behaviour

Screen-reader verification

  1. Use a screen reader with the browser combination being tested
  2. Submit a search that returns results
  3. Navigate by headings and record the available headings
  4. Check whether a “Results” heading can be used to reach the results
  5. Navigate by landmarks or skip links where supported
  6. Record whether the results area can be reached quickly
  7. Navigate through the extension titles and record their heading levels
  8. Repeat with a no-results search
  9. Repeat with at least one additional screen reader if available
  10. Record the screen-reader name, version, browser, and operating system

Verification after remediation

  1. Submit a search that returns results
  2. Confirm that a translatable “Results” heading identifies the results area
  3. Confirm that the heading can be used for navigation
  4. Confirm that extension titles use a logical heading level beneath it
  5. Confirm that the Categories heading and results heading form a clear structure
  6. Submit a no-results search and confirm that the results area remains identifiable
  7. Confirm that keyboard navigation and visible focus remain intact
  8. Record the final heading structure and screen-reader navigation behaviour

Version

6.2

Expected result

The Install from Web search results are identified by a translatable “Results” heading or equivalent navigable structure.

Users can move quickly to the results after submitting a search.

The heading hierarchy clearly relates the search, categories, and extension results.

Actual result

The Install from Web view has no structure indicating where search results begin.

The skip-link menu can focus on the Categories heading, but there is no equivalent way to reach the results quickly.

Extension titles use <h4> elements while the Categories heading uses <h3>.

The current Joomla 6.2 build needs to be checked to establish whether the issue persists.

What device were you using? (eg, phone, laptop)

Desktop web

What web browser were you using? (eg, Chrome, Safari)

Chrome, Firefox, Edge, Safari

Assistive Technology?

VoiceOver, JAWS, NVDA

Additional Comments

The browser and assistive-technology entries above are carried forward from the original issue and do not represent a new verification of every combination against Joomla 6.2.

Development is the responsibility tag in the original report.

The report's suggested level-3 “Results” heading is one possible structure. Verify the final heading level within the complete page hierarchy.

This issue concerns the structure and navigability of the results area. It does not require changing the search behaviour or the extensions returned.

MS2b is proposed for the shared extension-browser results structure, with MS3b covering the documented Installer integration.

avatar mbeganyi-a11y mbeganyi-a11y - open - 7 Sep 2026
avatar joomla-cms-bot joomla-cms-bot - change - 7 Sep 2026
Labels Added: No Code Attached Yet a11y
avatar joomla-cms-bot joomla-cms-bot - labeled - 7 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 7 Sep 2026
Labels Added: a11y-audit-backlog a11y-priority-moderate (Medium)
avatar mbeganyi-a11y mbeganyi-a11y - labeled - 7 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - labeled - 7 Sep 2026
avatar brianteeman
brianteeman - comment - 7 Sep 2026

please be more specific what this refers to. From the description here I would never have guessed that this was for the "install from web" functionality

avatar mbeganyi-a11y mbeganyi-a11y - change - 7 Sep 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 7 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 7 Sep 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 7 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 8 Sep 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 8 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 8 Sep 2026
Title
…
Search results are not marked up in code
Extension browser: install from Web search results are not marked up in code
avatar mbeganyi-a11y mbeganyi-a11y - edited - 8 Sep 2026
avatar mbeganyi-a11y mbeganyi-a11y - change - 26 Oct 2026
The description was changed
avatar mbeganyi-a11y mbeganyi-a11y - edited - 26 Oct 2026
avatar brianteeman
brianteeman - comment - 2 Nov 2026

This needs to be addressed upstream and not in Joomla core

Add a Comment

Login with GitHub to post a comment