How to fix object alt on WooCommerce

Steps for WooCommerce

1. In your WordPress admin, go to the page or product that contains the `<object>` element (Pages, Products, or Posts → Edit).
2. In the Gutenberg block editor, click the block containing the embed, then click the three-dot menu (⋮) → 'Edit as HTML' to access the raw markup.
3. Add `aria-label="Descriptive text here"` to the `<object>` opening tag, and/or add fallback text/link between the tags.
4. If the tag lives in your theme, navigate to Appearance → Theme File Editor and locate the relevant template file (e.g. `single-product.php` or a partial), make the edit there.
5. For page-builder pages (Elementor, Divi), use the widget's 'Advanced → Custom Attributes' panel to add `aria-label` without touching code.
6. Update/save and re-test with axe DevTools.

<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.