Skip to content

[Image] Excessively long alternative text #873

@coseeian

Description

@coseeian

Title

[Image] Excessively long alternative text

Description

An image (<img>) element on the page with very long (over 100 characters) alternative text. Non-text content must convey the same purpose or information as presented visually. When alt text is too long, users who rely on it may miss essential context or struggle to understand the content.

Steps to Reproduce

  1. go to tutorials/ and tutorials/setting-up-your-environment/
  2. Locate to the following element
<img class="aspect-photo object-cover" height="293" width="440" src="/_astro/SetupA.MT9CUmVs_UdPSt.webp" loading="eager" decoding="async" alt="An interactive sketch in the p5.js Web Editor draws circles on the canvas as the mouse pointer moves." style="">
<img height="1152" width="2048" src="/_astro/p5_editor_sign_up_page.ti-nvYfB_Z17jU5E.webp" loading="lazy" infersize="true" decoding="async" aspectratio="none" alt="An arrow pointing to the highlighted User Name, Emaill, Password, and Confirm Password fields on the Sign Up page." style="">

Actual Behavior

The image’s alt attribute contains more than 100 characters of description.

Expected Behavior

Alternative text should be concise and focused, describing the essential content and function of the image in a brief phrase or sentence.

Environments

No response

Suggested Fix

  1. Keep the alt text brief and focused—describe only the image’s essential purpose in a few words.
  2. If readers need more context, place supplementary details next to the image or link to a separate description page.
  3. Avoid hiding unique information solely in the alt text; ensure all critical content is visible elsewhere on the page.

Reference

What is your operating system?

None

Web browser and version

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Accessibility: Low SeverityMinor impact or no clear violation of a11y guidelines, but still a negative experience

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions