How to fix label title only on Adobe Commerce (Magento)

Add a visible, persistent label to every form field so it is never labeled only by a tooltip (title) or hidden description (aria-describedby).

Steps for Adobe Commerce (Magento)

  1. Identify the PHTML template responsible for the flagged form field. Common locations: `app/design/frontend/VENDOR/THEME/Magento_Checkout/templates/form/` (checkout), `Magento_Customer/templates/form/` (login/register), `Magento_Search/templates/` (search).
  2. Copy the core template into your custom theme's folder (following Magento's template override convention) so you do not edit core files directly.
  3. In the copied template, locate the `<input>` element. Add `<label for="FIELD_ID">Visible Label Text</label>` before it and ensure the input has `id="FIELD_ID"`. For design-constrained fields (e.g., the top search bar), add `aria-label="Search"` directly on the `<input>` and remove the `title`-only attribute.
  4. Run `bin/magento cache:clean` and `bin/magento setup:static-content:deploy` after saving template changes.
  5. Verify in a staging environment with an accessibility scanner before deploying to production.
Official Adobe Commerce (Magento) documentation ↗
<label for="email-field">Email address</label>
<input type="email" id="email-field" name="email" placeholder="you@example.com">

<!-- OR, for a visually-constrained search bar where a visible label isn't shown: -->
<input type="search" aria-label="Search products" placeholder="Search…">

<!-- ❌ WRONG — title-only or aria-describedby-only labeling: -->
<input type="email" title="Enter your email" placeholder="Email">
<input type="text" aria-describedby="hint-text"><span id="hint-text">Your name</span>

What is label title only?

Every input field on your website — search boxes, email fields, quantity pickers, checkout fields, newsletter sign-ups — needs a clearly visible label that tells the user what to type. Right now, one or more of your fields uses only a "title" attribute (which shows as a browser tooltip on hover) or an `aria-describedby` attribute (which is hidden to sighted users) as its label. These hidden or tooltip-only labels look fine to most visitors, but they are invisible to screen readers used in the way they expect, and they disappear entirely on touch screens, keyboard-only navigation, and many assistive technologies. A true accessible label is text that is always visible on screen next to the field, or at minimum announced correctly by all assistive technology via a proper `<label>` element or `aria-label`.

Failing this check means your store is not compliant with WCAG 2.1 Success Criterion 1.3.1 (Info and Relationships) and 3.3.2 (Labels or Instructions), which are the accessibility standards referenced by ADA, Section 508, and the European Accessibility Act. This creates real legal risk — accessibility lawsuits against e-commerce stores have increased sharply, and missing form labels are one of the most commonly cited issues. Beyond legal exposure, unlabeled fields make checkout and sign-up forms unusable for the roughly 1-in-5 shoppers who have a disability, directly costing you conversions. Search engines also use accessible markup as a quality signal, so fixing this supports your overall SEO health.

See the complete Label title only guide for every platform and the full background.

Not sure if your Adobe Commerce (Magento) store has this?

Run a free SEOLZ audit — we’ll find label title only and every other issue across your whole site.

Scan my site free

Fix label title only on another platform