How to fix object alt on Adobe Commerce (Magento)

Steps for Adobe Commerce (Magento)

1. Connect to your server and locate the relevant PHTML template file (e.g. under `app/design/frontend/<Vendor>/<Theme>/Magento_Catalog/templates/` or a custom module's `view/frontend/templates/`).
2. Find the `<object>` tag and add `aria-label="Descriptive text here"` to the opening tag; also add meaningful fallback text or a link between the open and close tags.
3. If the object is placed via a CMS page or block: in the admin, go to Content → Pages (or Blocks) → Edit the relevant item → click 'Show/Hide Editor' to reveal the raw HTML, then edit the `<object>` tag.
4. Clear the Magento cache: System → Cache Management → Flush Magento Cache (or run `bin/magento cache:flush` via CLI).
5. Verify on the front end using the axe DevTools browser extension.

<object data="product-spec.pdf" type="application/pdf" aria-label="Product specification sheet for Model X (PDF)">
  <a href="product-spec.pdf">Download the Product Specification Sheet for Model X (PDF)</a>
</object>

What is object alt?

The HTML `<object>` tag 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>` embeds — has a meaningful text alternative that describes what it is or what it does. This alternative can be provided via an `aria-label` attribute, an `aria-labelledby` attribute pointing to visible text, or fallback text placed inside the `<object>` tag itself. Without one, the element is invisible to assistive technology.

Screen readers used by blind and low-vision shoppers will skip over or announce an `<object>` element as meaningless — saying something like "unlabelled graphic" or nothing at all — if it has no text alternative. This creates a broken experience for those customers: they may miss a product demo, an embedded PDF data sheet, or a promotional graphic, which can directly cost you sales. Legally, failing WCAG 1.1.1 exposes your store to accessibility complaints and lawsuits under the ADA (US), EAA (EU), AODA (Canada), and equivalent laws in many other countries. Search engines also use text alternatives as indexable content signals, so labelling embedded objects can marginally help SEO for the content they contain.

See the complete Object alt guide for every platform and the full background.