Repository navigation
Description
Steps to reproduce the issue
| Milestone 1a finding ID | M1a-028 |
|---|---|
| Backlog priority | Low |
| Severity — carried from Milestone 1a | Minor |
| Implementation effort | Low |
| Target milestone(s) | MS2a — Design Tokens and Core Components; MS3b — Backend Template Build |
| WCAG 2.2 success criterion | 1.4.3 Contrast (Minimum); 1.4.11 Non-text Contrast |
| Responsibility tag(s) from report | Design |
| Affected Joomla area/component | Installer — Commercial $ icon and full-word Commercial badge — Milestone 1a finding #28 |
| Affected user journey(s) | 07 — Installer Wizard (com_installer/Install) |
Audit finding
The Commercial indicator is displayed as a white $ icon on a yellow background and, on a plugin detail page, as a full-word “Commercial” badge.
The report states that neither presentation meets the applicable contrast requirements.
For the $ icon, a contrast ratio of at least 3:1 is sufficient under 1.4.11 Non-text Contrast. For the full-word badge text, 1.4.3 Contrast (Minimum) applies.
The report recommends using a contrast ratio of at least 4.5:1 for both presentations, so that the icon and badge use a consistent, more readable treatment.
It suggests dark text for both the icon and the word, and considers adding a dark outline around both.
User impact
People with low vision may have difficulty recognizing the $ icon as a Commercial indicator, particularly where the white symbol sits on a light yellow background.
The low-contrast full-word badge may be difficult to read on the plugin detail page. Users may not reliably understand that an extension is commercial before installing or configuring it.
A consistent treatment across the compact icon and full-word badge reduces the chance that the same status is easy to recognize in one place but difficult to recognize in another.
Remediation plan
Make the Commercial icon and badge readable against their actual backgrounds
- Give the
$icon a contrast ratio of at least 3:1 against its yellow background - Give the full-word “Commercial” badge text a contrast ratio of at least 4.5:1 against its background
- Consider the report's recommendation to use at least 4.5:1 for both the icon and badge, providing a consistent treatment
- Use dark text for the icon and word where appropriate for the chosen background
- Consider a dark outline around the icon and badge if it improves visibility without creating visual clutter
- Verify the rendered colours after opacity, inheritance, and template styles are applied
- Check the compact icon and full-word badge separately
- Check the badge on the relevant extension detail view as well as any list or installer context where it appears
- Preserve the meaning of the Commercial status and ensure it remains programmatically determinable
- Do not rely on colour alone to convey the Commercial status
- Check hover, focus, selected, and genuinely disabled states where those states exist
Preconditions
- Use Joomla 6.2 with the Atum administrator template
- Sign in with an account permitted to access the Installer
- Use a test installation containing an extension that displays the Commercial indicator
- Record the exact extension, its version, and the view on which each indicator appears
- Record the exact Joomla build, browser name and version, operating system, viewport dimensions, and browser zoom
- Start at 100% browser zoom
- Record the active appearance and any template overrides or custom CSS
- Do not install, update, or uninstall an extension merely to measure contrast
Steps to reproduce — Commercial $ icon
- Open the Joomla administrator interface at the site's base URL followed by
/administrator/ - Open System → Install → Extensions
- Alternatively, navigate to
/administrator/index.php?option=com_installeron the same installation - Record the navigation labels if they differ in the tested build
- Alternatively, navigate to
- Locate an extension entry displaying the Commercial
$icon - Record the extension name, version, and view where the icon appears
- Move the pointer away and keep keyboard focus elsewhere
- Inspect the
$icon using Developer Tools - Record the rendered icon colour, opacity, and adjacent badge background colour
- Measure the contrast ratio with a contrast-checking tool
- Compare the result with the 3:1 minimum for the informative icon
- Check whether the audited white-on-yellow combination is reproduced
- Record the actual values if the tested build differs
- Check hover, focus, and any selected state separately
- Capture the icon, surrounding badge, and measurement
Steps to reproduce — full-word Commercial badge
- Remain in the Installer or open the relevant extension detail view
- Locate the extension's full-word “Commercial” badge
- Record the exact view and extension on which it appears
- Move the pointer away and keep keyboard focus elsewhere
- Inspect the badge text and its background using Developer Tools
- Record the rendered text colour, background colour, opacity, and any border or outline
- Measure the contrast ratio between the badge text and its background
- Compare the result with the 4.5:1 minimum for the badge text
- Check whether the audited low-contrast combination is reproduced
- Check hover, focus, and any selected state separately
- Capture the badge, surrounding background, and measurement
Additional verification
- Compare the compact
$icon and full-word badge to confirm that they communicate the same status consistently - Check the indicator at 200% browser zoom
- Confirm that the Commercial status is not conveyed by colour alone
- If a control is genuinely disabled, record why it is inactive and assess it separately
- Do not treat a change to the icon as evidence that the full-word badge is resolved, or vice versa
Version
6.2
Expected result
The Commercial $ icon has a contrast ratio of at least 3:1 against its adjacent background.
The full-word “Commercial” badge text has a contrast ratio of at least 4.5:1 against its background.
The report recommends using at least 4.5:1 for both presentations so that the Commercial status is consistently readable.
Actual result
The audit reports that the white $ icon on a yellow background and the corresponding full-word “Commercial” badge do not meet the applicable contrast requirements.
Exact colour values and contrast ratios need to be recorded for the Joomla 6.2 build and extension configuration being tested.
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?
N/A
Additional Comments
The browser entries above are carried forward from the original issue and do not represent a new verification of every browser against Joomla 6.2.
Design is the responsibility tag in the original report.
The original issue's steps refer to an extension list, while the report's full-word badge example is on a plugin detail page. Record the exact view and extension where each indicator is reproduced.
The report does not provide exact colour values or contrast measurements. Record measured results rather than borrowing values from another badge finding.
The icon and badge are assessed under different success criteria. Do not apply the 4.5:1 text threshold to the icon as a WCAG minimum, although the report recommends it as a consistent design target.
MS2a is proposed for shared badge and icon styling, with MS3b covering the documented Installer integration.
Activity
[-]$ icon/Commercial badge has insufficient contrast[/-][+]Atum: Extensions - Install: $ icon/Commercial badge has insufficient contrast[/+]mbeganyi-a11y commentedon Sep 13, 2026
From what I can see, the affected markup and stylesheet appear to be supplied by the remote com_apps Install-from-Web application. The com_apps component powers the Install from Web service, rather than the core CMS template. Do I have this right? Just curious for scoping purposes.
brianteeman commentedon Sep 14, 2026
If its just the css then that is here https://github.com/joomla/joomla-cms/blob/6.1-dev/build/media_source/plg_installer_webinstaller/scss/client.scss
brianteeman commentedon Nov 1, 2026
please test #48743