How to fix object alt on Squarespace

Steps for Squarespace

1. In the Squarespace editor, click on the block that contains the embedded object (usually a Code Block or Embed Block).
2. If it is a Code Block: click the pencil/edit icon, switch to 'HTML' mode, and add `aria-label="Descriptive text here"` to the `<object>` tag.
3. If it is an Embed Block with a raw embed code, click the block → Edit → paste the corrected HTML with the `aria-label` attribute into the code field.
4. For content injected via Settings → Advanced → Code Injection, find your `<object>` snippet and add the attribute there.
5. Save and apply, then test with the axe DevTools browser extension in a preview or published view.

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