How to fix object alt on Adobe Commerce (Magento)
Add a meaningful text alternative (via `title` attribute or `aria-label`) to every `<object>` element so screen readers can describe its content to users who cannot see it.
Steps for Adobe Commerce (Magento)
- Access your Magento installation via FTP/SSH or the Admin panel's built-in editor.
- Identify the template file containing the <object> tag. Common locations: app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/ or a custom module's templates/ directory.
- Open the .phtml file and locate the <object> element.
- Add `title='<?= $block->escapeHtmlAttr(__('Descriptive label here')) ?>'` to the <object> tag, using Magento's escaping helper to prevent XSS.
- If the <object> is in a CMS Page or CMS Block (Content → Pages or Content → Blocks), edit that content, switch to HTML view in the editor, and add the `title` attribute.
- Clear the Magento cache (System → Cache Management → Flush Magento Cache), then verify with axe DevTools.
What is object alt?
An HTML `<object>` element is used to embed content like PDFs, Flash files, SVGs, or other media directly in a web page. WCAG Success Criterion 1.1.1 (Non-text Content) requires that every non-text element — including `<object>` — has a text alternative that describes what it contains or does. When an `<object>` has no `title` attribute and no `aria-label`, screen readers (used by blind and low-vision shoppers) have nothing to announce, so that content is invisible to them. The fix is simple: add a short, descriptive label directly to the element.
Failing WCAG 1.1.1 is one of the most commonly cited violations in accessibility audits and lawsuits — in the US (ADA), EU (EAA/EN 301 549), and other jurisdictions, online stores are increasingly required to be accessible. A missing text alternative on an embedded product brochure, size guide PDF, or interactive viewer means blind customers cannot access that content at all, directly harming conversions and creating legal exposure. Google also uses accessibility signals as a quality indicator, and unresolvable non-text content can limit how well your pages are crawled and understood. Fixing it takes under five minutes per element and eliminates both the compliance risk and the customer experience gap.
See the complete Object alt guide for every platform and the full background.
Not sure if your Adobe Commerce (Magento) store has this?
Run a free SEOLZ scan — we’ll find object alt and every other issue across your whole site.
Scan my site free