From 3ad4115ed8f099c1154ffbf7b72bd0db245baf4b Mon Sep 17 00:00:00 2001
From: Andrew Zenk <andrew@andrewzenk.com>
Date: Wed, 2 Dec 2020 05:53:53 -0600
Subject: [PATCH] tpl: Add title parameter to YouTube shortcode

---
 content/en/content-management/shortcodes.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/content/en/content-management/shortcodes.md b/content/en/content-management/shortcodes.md
index a298bc425..2b4d0d632 100644
--- a/content/en/content-management/shortcodes.md
+++ b/content/en/content-management/shortcodes.md
@@ -398,6 +398,13 @@ Furthermore, you can automatically start playback of the embedded video by setti
 {{</* youtube id="w7Ft2ymGmfc" autoplay="true" */>}}
 {{< /code >}}
 
+For [accessibility reasons](https://dequeuniversity.com/tips/provide-iframe-titles), it's best to provide a title for your YouTube video.  You  can do this using the shortcode by providing a `title` parameter. If no title is provided, a default of "YouTube Video" will be used.
+
+{{< code file="example-youtube-input-with-title.md" >}}
+{{</* youtube id="w7Ft2ymGmfc" title="A New Hugo Site in Under Two Minutes" */>}}
+{{< /code >}}
+
+
 #### Example `youtube` Output
 
 Using the preceding `youtube` example, the following HTML will be added to your rendered website's markup: