From 4dd5c85d3340f14f82e9fe2c6b9a0f8a87d67fee Mon Sep 17 00:00:00 2001
From: Carlos Scheidegger <carlos.scheidegger@posit.co>
Date: Mon, 6 Oct 2025 18:16:59 -0500
Subject: [PATCH] docs for quarto-cli #13508

---
 docs/authoring/videos.qmd           | 16 ++++++++++++++--
 docs/prerelease/1.9/_highlights.qmd |  4 +++-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/docs/authoring/videos.qmd b/docs/authoring/videos.qmd
index e9e8d10134..12c63f565b 100644
--- a/docs/authoring/videos.qmd
+++ b/docs/authoring/videos.qmd
@@ -92,11 +92,23 @@ For YouTube videos, you can specify a `start` option to indicate how many second
 The `title` option adds a `title` attribute to the video `<iframe>`:
 
 ``` {.default shortcodes="false"}
-{{< video https://www.youtube.com/embed/wo9vZccmqwc 
-    title='What is the CERN?' 
+{{< video https://www.youtube.com/embed/wo9vZccmqwc
+    title='What is the CERN?'
 >}}
 ```
 
+### Accessibility Label
+
+The `aria-label` option provides a custom accessibility label for screen readers. By default, embedded videos use the generic label "Video Player", but you can provide a more descriptive label:
+
+``` {.default shortcodes="false"}
+{{< video https://www.youtube.com/embed/wo9vZccmqwc
+    aria-label="Video demonstration of particle physics experiments at CERN"
+>}}
+```
+
+This works with all video types including YouTube, Vimeo, Brightcove, and local video files.
+
 ## Revealjs {#revealjs}
 
 You can include videos within [Revealjs](/docs/presentations/revealjs/index.qmd) presentations in one of two ways:
diff --git a/docs/prerelease/1.9/_highlights.qmd b/docs/prerelease/1.9/_highlights.qmd
index 2dbb2b05dd..b099f0a68d 100644
--- a/docs/prerelease/1.9/_highlights.qmd
+++ b/docs/prerelease/1.9/_highlights.qmd
@@ -1 +1,3 @@
-Quarto 1.9 includes the following new features:
\ No newline at end of file
+Quarto 1.9 includes the following new features:
+
+- [`aria-label` for videos](/docs/authoring/videos.qmd#accessibility-label): Improve accessibility of embedded videos by providing custom descriptive labels for screen readers instead of the default "Video Player" label.
\ No newline at end of file