How to fix aria progressbar name on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. Locate the template file that renders the progress bar. Common locations: `app/design/frontend/<Vendor>/<theme>/Magento_Checkout/templates/progress-bar.phtml` (checkout steps), or a custom module template.
2. Open the `.phtml` file and add `aria-label="<?= $escaper->escapeHtmlAttr(__('Checkout progress')) ?>"` (or `aria-labelledby`) to the element tag. Use Magento's `__()` translation function so the label is translatable.
3. For the password-strength meter (`Magento_Customer` module), override `app/design/frontend/<Vendor>/<theme>/Magento_Customer/templates/widget/password/strength_indicator.phtml` in your custom theme and add the `aria-label` attribute.
4. Run `bin/magento setup:static-content:deploy` and `bin/magento cache:flush` after saving template changes.
5. Verify in the browser Accessibility panel and with an automated scan (e.g., axe DevTools extension).

<!-- OPTION A: aria-label (no visible label nearby) -->
<div
  role="progressbar"
  aria-label="Password strength"
  aria-valuenow="60"
  aria-valuemin="0"
  aria-valuemax="100"
  style="width:60%;"
></div>

<!-- OPTION B: aria-labelledby (visible label exists) -->
<p id="upload-label">File upload progress</p>
<div
  role="progressbar"
  aria-labelledby="upload-label"
  aria-valuenow="40"
  aria-valuemin="0"
  aria-valuemax="100"
  style="width:40%;"
></div>

<!-- OPTION C: native <progress> with <label> -->
<label for="checkout-progress">Checkout: step 2 of 4</label>
<progress id="checkout-progress" value="50" max="100">50%</progress>

What is aria progressbar name?

A progress bar (any HTML element with `role="progressbar"`, including native `<progress>` elements) must have an accessible name — a short label that tells users *what* is progressing. This name is provided via an `aria-label` attribute directly on the element, or by pointing to a visible label using `aria-labelledby`. When neither exists, the progress bar is completely anonymous: assistive technologies announce it as just "progress bar, 0%" with no context about what is being tracked — a password strength meter, a checkout step, a file upload, etc.

Screen reader users — including customers who are blind or have low vision — rely on accessible names to understand your store's interface. An unnamed progress bar during checkout, a file upload, or a product review form creates confusion and can cause those shoppers to abandon the task entirely, costing you sales and harming your brand reputation. Failing to provide accessible names for interactive or informative widgets violates WCAG 2.1 Success Criterion 1.1.1 (Non-text Content) and 4.1.2 (Name, Role, Value), exposing your store to accessibility complaints and potential legal liability in many jurisdictions (e.g., ADA in the US, EN 301 549 in the EU). Fixing it is a quick code change with zero impact on visual design.

See the complete Aria progressbar name guide for every platform and the full background.