How to fix label title only on Magento Open Source

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 Magento Open Source

  1. Follow the same process as Adobe Commerce (Magento) above — override the relevant PHTML template in your custom theme directory.
  2. After adding visible `<label>` elements or `aria-label` attributes, clear the Magento cache: Admin → System → Cache Management → Flush Magento Cache.
  3. Test on staging before deploying to production.
Official Magento Open Source 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 Magento Open Source 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