[wp-trac] [WordPress Trac] #63519: Add accessibility name to core/video block using a caption

WordPress Trac noreply at wordpress.org
Tue Jun 3 09:04:04 UTC 2025


#63519: Add accessibility name to core/video block using a caption
---------------------------+-----------------------------
 Reporter:  rlautan        |      Owner:  (none)
     Type:  enhancement    |     Status:  new
 Priority:  normal         |  Milestone:  Awaiting Review
Component:  Media          |    Version:  6.8
 Severity:  normal         |   Keywords:
  Focuses:  accessibility  |
---------------------------+-----------------------------
 Background: We came across this issue when we had an external company
 review an entire government affiliated website for web accessibility.
 Aiming for WCAG 2.1 AA with a score above 80%.

 A core/video block that uses a caption has no accesibility name. Adding
 one as a aria-label or a aria-labbeledby attribute will enhance the
 accessibility for the block.

 Create a page and add a video block with a caption to it. Inspect the
 element with the accessibility tree. You will notice there is no
 accessible name for the video. Using VoiceOver to navigate to the video
 gives us no feedback and the relation between the video and caption
 doesn't exist.

 Solution: Adding aria-labelledby to the video with a relation to the
 caption fixes this issue.

 Extra info about figure and figcaptions, outdated but still somewhat true:
 https://examples.hassellinclusion.com/images/figure-figcaption01.html

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/63519>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list