Enable Alt Text Field for Cover Image in Remote Video and Local Video Media Types to Improve Accessibility

Created on 15 October 2025, 5 days ago

Problem/Motivation

Currently, the Cover Image field in both the Remote Video and Local Video media types does not include an Alt text field.
This makes the media items less accessible to users who rely on screen readers, as they cannot understand the visual context provided by cover images when the video itself is not playing or visible.

According to WCAG 2.2 - Guideline 1.1 (Text Alternatives), all meaningful images must include a text alternative to describe their purpose or content.

Without Alt text:
Screen readers skip over important visual content.
Accessibility audits (Lighthouse, axe DevTools, etc.) raise errors for missing alt attributes.
Content editors cannot add meaningful image descriptions for accessibility or SEO purposes.

Example
Media Type: Remote Video
Field: field_media_cover_image
Current behavior: The referenced image does not provide a text alternative field.
Expected behavior: Editors should be able to add an Alt text when uploading or referencing the image.

Steps to reproduce

  1. Go to Structure : Media Types : Remote Video (or Local Video).
  2. Open Manage Fields and edit the Cover Image field.
  3. Observe that the referenced image field does not have the “Alt text” option enabled.
  4. Create or edit a video media item - there’s no way to enter Alt text for the thumbnail image.
  5. Run an accessibility scan (axe, Lighthouse) on the rendered video - notice the missing alt attribute for the cover image.

Proposed resolution

Enable the Alt field in the image reference settings for:

  • field_media_cover_image in Remote Video media type.
  • field_media_cover_image in Local Video media type.
  • Verify that the Alt text is rendered in all templates and displays that include cover images.
  • Change Varbase Demo and Varbase Media Demo ( default content ) to include alt text values in demo content.

Remaining tasks

  • ✅ File an issue about this project
  • ❌ Addition/Change/Update/Fix to this project
  • ❌ Testing to ensure no regression
  • ➖ Automated unit/functional testing coverage
  • ➖ Developer Documentation support on feature change/addition
  • ➖ User Guide Documentation support on feature change/addition
  • ➖ UX/UI designer responsibilities
  • ➖ Accessibility and Readability
  • ❌ Code review from 1 Varbase core team member
  • ❌ Full testing and approval
  • ❌ Credit contributors
  • ❌ Review with the product owner
  • ❌ Update Release Notes and Update Helper on new feature change/addition
  • ❌ Release

Varbase update type

  • ✅ No Update
  • ➖ Optional Update
  • ➖ Forced Update
  • ➖ Forced Update if Unchanged

User interface changes

  • N/A

API changes

  • N/A

Data model changes

  • N/A

Release notes snippet

  • N/A
📌 Task
Status

Active

Version

10.1

Component

Code

Created by

🇯🇴Jordan Rajab Natshah Jordan

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

No activities found.

Production build 0.71.5 2024