Logo

What are you looking for?

Get help straight from our team...

Provide alternative content for objects

Accessibility Tips

Provide alternative content for objects

Include informative alternate text for <object> elements to convey their meaning to screen reader users who cannot access the embedded content directly.

Last updated on 11 Nov, 2025

***This document provides helpful tips to improve your site's accessibility. While it doesn’t guarantee 100% compliance, it’s a great starting point to make your website more inclusive and user-friendly.***


Identification

<object> elements must have alternative text (Rule ID: object-alt)

 

Applicable Standards

  • WCAG 2.0, 2.1, 2.2 Level A (1.1.1)

  • Section 508 (1194.22)

  • EN 301 549

 

Impact

Serious level impact affecting:

  • Blind users

  • Deafblind users

 

Proper Implementation

Object elements must have text alternatives using one of:

  • aria-label attribute

  • aria-labelledby attribute

  • title attribute

  • Presentation/none role for decorative objects

 

Examples of Correct Usage

  1. Using Fallback Text Inside the <object> Element:
    Fallback text provides an alternative for users whose browsers do not support the embedded PDF, ensuring the content remains accessible.

Image
  1. Using aria-label for Accessible Description:
    The aria-label attribute provides a concise description of the embedded object for screen reader users.

Image
  1. Using aria-labelledby to Reference an External Description:
    The aria-labelledby attribute references an external element (<div> in this case) to provide a detailed description of the object.

Image
  1. Using the title Attribute for a Simple Description:
    A title attribute is used to describe the content of the embedded video for screen reader users.

Image
  1. Marking Decorative <object> as Presentation:
    The role="presentation" attribute marks the object as decorative, ensuring it is ignored by assistive technologies like screen readers.

Image

Common Errors to Avoid

  1. Missing Alternative Text or Fallback Content:

      The <object> element lacks both fallback content and alternative text, making it inaccessible to screen reader users and anyone whose browser does not support the object type.

Image
  1. Using Incomplete or Vague Alternative Descriptions:
    The aria-label ("Chart") is too vague and does not provide meaningful information about the content, reducing its usefulness for screen reader users.

Image
  1. Missing role="presentation" for Decorative Objects:
    A purely decorative <object> is missing the role="presentation", causing unnecessary announcements by screen readers.

Image
  1. Using title Attribute Without Fallback Content:
    While the title attribute provides a description, the lack of fallback content means users without support for the embedded object cannot access the content.

Image
  1. Fallback Content Does Not Convey the Same Information:
    The fallback content ("Placeholder text") does not provide equivalent information to the embedded object, leaving users without a meaningful alternative.

Image


Rationale

Alternative text is essential because:

  • Screen readers cannot interpret non-text content

  • Users need to understand the object's purpose and content

  • Alternative text should convey same information as visual content

  • Helps users decide whether to interact with the object


Evaluation Method

  1. Inspect the Code

    • Ensure <object> elements include at least one of the following:

      • Fallback content inside the <object> element.

      • Descriptive attributes (aria-label, aria-labelledby, or title).

      • role="presentation" for purely decorative objects.

  2. Test with a Screen Reader

    • Use a screen reader (e.g., NVDA, JAWS, or VoiceOver) to navigate the page.

    • Verify that the alternative text or fallback content is announced when the <object> element is encountered.

  3. Disable Embedded Object Support

    • Temporarily disable support for the embedded object type in your browser (e.g., disable PDF plugins).

    • Ensure fallback content or alternative text is displayed when the object cannot load.


Evaluation Checklist

Image
Did you find this article helpful?
Previous

Label select elements clearly

Next