Make WordPress Core

Opened 6 weeks ago

Last modified 3 hours ago

#64374 accepted enhancement

Alt text helper text can be more educational and visual indicator of opening in new tab

Reported by: burtrw's profile burtrw Owned by: joedolson's profile joedolson
Milestone: 7.0 Priority: normal
Severity: minor Version:
Component: Media Keywords: has-patch changes-requested
Focuses: accessibility Cc:

Description (last modified by sabernhardt)

When viewing an image (media attachment), there is an input field for 'Alternative Text'.

Under the input field is helper text of:

Learn how to describe the purpose of the image (opens in a new tab). Leave empty if the image is purely decorative.

There should be a visual indicator that the link opens in a new tab. The helper text can also be made more concise and educational.

Suggested improvement:

Alt text describes the image's purpose. Leave it blank if the image is purely decorative. Learn more about alt text (opens in a new tab).

With the open in new tab dash icon at the end.

Attachments (1)

Screenshot 2025-12-09 105250.png (8.0 KB) - added by joedolson 6 weeks ago.
Alt text instructions in the block editor

Download all attachments as: .zip

Change History (9)

This ticket was mentioned in PR #10609 on WordPress/wordpress-develop by @burtrw.


6 weeks ago
#1

  • Keywords has-patch added

…st screen and media manager templates.

Updates the alt text description text in both the media attachment post screen and media manager templates. The new text is clearer and more concise, and includes an external link icon for better user experience.

Trac ticket: https://core.trac.wordpress.org/ticket/64374

---
This Pull Request is for code review only. Please keep all other discussion in the Trac ticket. Do not merge this Pull Request. See GitHub Pull Requests for Code Review in the Core Handbook for more details.

#2 @sabernhardt
6 weeks ago

  • Description modified (diff)
  • Version trunk deleted

This ticket was mentioned in Slack in #accessibility by joedolson. View the logs.


6 weeks ago

@joedolson
6 weeks ago

Alt text instructions in the block editor

#4 @joedolson
6 weeks ago

  • Milestone changed from Awaiting Review to 7.0
  • Owner changed from burtrw to joedolson
  • Status changed from assigned to accepted

Noting that the use of an icon would be consistent with the block editor, and a visual indicator is required; the current screen reader text is insufficient.

I'm also noting that the alt text instructions are currently not consistent between the media library and the block editor, and those should be re-aligned.

I'm not convinced by the changes you're suggesting, @burtrw; they make an already long instruction even longer, and I'm not convinced we need to be that verbose. Happy to hear your arguments, though.

#5 @burtrw
6 weeks ago

Appreciate the feedback @joedolson.

they make an already long instruction even longer

I agree, I don't like this. And I'd prefer consistency and brevity everywhere.

I really struggle with the current text of the link being 'Describe the purpose of the image.' as I don't really know why I would click on that link. That is what prompted me to open this ticket and propose a solution.

My first attempt was closer to:

Alt text describes the purpose of the image. Leave empty if decorative. [Learn more].

But then I didn't like the 'Learn more' text as it was not descriptive enough. Hm.

#6 @sabernhardt
6 weeks ago

  • Description modified (diff)

(editing ticket description to hide screen reader text visually and to show the dashicon)

This ticket was mentioned in Slack in #accessibility by joedolson. View the logs.


11 hours ago

#8 @audrasjb
3 hours ago

  • Keywords changes-requested added

I would simply start by adding the visual indicator. The current text looks good to me.

Note: See TracTickets for help on using tickets.