I was working on this simple static website that should have an YouTube video displayed right on the landing page. So I went my merry way, hopped onto YouTube, snatched the embed code, pasted it into my editor and called it a day.
The thing is the job was specifically to deliver high performance, accessibility and modern practices, so you can imagine my annoyance when I noticed that just for having this <iframe>
I got this:
Plus a few extra requests that my ad blocker handled for me.
That is over 500KB that my users would have to download on top of the website, regardless if they'll watch the video. Do you have any idea how heavy this might hit your users, specially the ones with slow connection or low performing machines? To add insult to injury they'd also be being tracked—Hi Google—for just loading a video they didn't even know was there.
It being a simple static website I wanted to keep my solution to a minimum, so here's what I came up with.
The code for embedding an YouTube video, as of August 2019, goes like this:
<iframe
width="560"
height="315"
src="https://www.youtube.com/embed/Y8Wp3dafaMQ"
frameborder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen>
</iframe>
So I thought what if instead of the actual video I showed just its cover linked to the video? It would still kinda look like an embedded video but it would require only a single image upfront. Thankfully YouTube has an URL schema for video thumbnails.
<a href="https://www.youtube.com/embed/Y8Wp3dafaMQ">
<img src="https://i3.ytimg.com/vi/Y8Wp3dafaMQ/hqdefault.jpg">
</a>
Cool, but I really don't want to have to create a whole new page just for this teeny tiny snippet of code. Well, we're in luck cause <iframe>
has just the perfect thing for us—the srcdoc attribute. With it you can source the <iframe>
directly in the hosting page. Just beware that it won't work on Edge or IE and that we can't use double quotes.
<iframe
...
srcdoc="<a href=https://www.youtube.com/embed/Y8Wp3dafaMQ><img src=https://i3.ytimg.com/vi/Y8Wp3dafaMQ/hqdefault.jpg></a>">
</iframe>
Finally you'll notice that if we click the image it'll load the video but in a paused state and we would need to click it again to start watching. Fret not, cause the embed video URL supports player parameters and among those there's the autoplay
variable which does exactly what you would expect. Additionally due to browser's default style users on systems with scrollbar—namely not macOS—will see an unnecessary scrollbar, but nothing that a small CSS reset wouldn't fix.
Remy Sharp pointed out we should keep the src
as fallback to browsers that don't support srcdoc
. Adrian Roselli suggested a few tweaks to improve accessibility. Also, while applying these suggestions I fixed the image position so it stays centered both horizontally and vertically without resorting to background-size: cover
. Thank you guys for your feedback! 🤩️
Here's the final result:
The <iframe>
singled out:
<iframe
width="560"
height="315"
src="https://www.youtube.com/embed/Y8Wp3dafaMQ"
srcdoc="<style>*{padding:0;margin:0;overflow:hidden}html,body{height:100%}img,span{position:absolute;width:100%;top:0;bottom:0;margin:auto}span{height:1.5em;text-align:center;font:48px/1.5 sans-serif;color:white;text-shadow:0 0 0.5em black}</style><a href=https://www.youtube.com/embed/Y8Wp3dafaMQ?autoplay=1><img src=https://img.youtube.com/vi/Y8Wp3dafaMQ/hqdefault.jpg alt='Video The Dark Knight Rises: What Went Wrong? – Wisecrack Edition'><span>▶</span></a>"
frameborder="0"
allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture"
allowfullscreen
title="The Dark Knight Rises: What Went Wrong? – Wisecrack Edition"
></iframe>
This way all the users will have to download upfront is the cover image, which seems pretty reasonable to me. You can customize it further, e.g. make use of the different thumbnail sizes for different devices, and if you need more control over what the user will load and what features to enable you can always explore the YouTube Player API.
If you've got any questions, corrections or suggestions feel free to comment below. Thank you for your time. 😊️
Top comments (34)
Great post. I wrote a reply on my blog about better support: remysharp.com/2019/08/09/redux-laz... - but the TL;DR is: add the
src
attribute as a fallback for whensrcdoc
isn't supported 👍Well pointed out. I have edited the post. Thank you!
Three suggestions:
title
attribute to the<iframe>
(excluding it is a WCAG failure, one which Google continues to ignore),alt
attribute on the image.I mocked one up on CodePen: codepen.io/aardrian/pen/pMVWxQ
Debug view: s.codepen.io/aardrian/debug/pMVWxQ
Great suggestions! I have edited the article to reflect this change. Thank you!
Hi! I wrote you a reply here:
doveranalyst.com/2020/12/how-to-lo...
It is working on desktop but on mobile devices the autoplay is not working.
And the Unicode use does not stay Unicode like. Have shared screenshots.
Please have a look.
The video is not autoplaying on my mobile device, a Moto G4 Play. For some reason I have to double click 😞
Can I haz
<lazy-youtube>
web component? 😁My exact same thoughts. This wants to be abstracted away.
Very nice and simple solution.
Speaking from personal experience having worked on the past with video heavy website.
Now it might as well be a video light website. 😂️
My God you're a lifesaver! Just implemented this on doveranalyst/p/videos.html
A quick solution for the playlist embed not working was to replace ?rel=0 with &rel=0.
Added modest branding also.
Looks delicious on desktop version.
But on mobile version a bright blue play icon comes.
Is there any way to have same white dupe you created in style to show on mobile chrome?
And is there any way we can have this style for the play and image placement done only once?
God bless ya.
I was tired of JavaScript making page load so bad.
My page speed score changed from 30 to 70 google page insights after this change🤩🤩🤩
Clearly you originally used the video youtube.com/watch?v=27rhHfBugnc then changed your mind but didn't update the IMG SRC URLs, which makes it a little confusing (especially the bit about the YouTube URL schema for video thumbnails) so please update code snippets 2/3/4 accordingly! ;)
You're most correct, sir. The thing is I checked those so many times and it still slipped. 😅️ Well, it should be fixed now. Thank you!
Using
autoplay
is not ideal, as more and more browsers, especially mobile ones, don't support it. This means that on these browsers, you will have to double tap/click, which feels a little bit clunky in my opinion.That's true, it doesn't work on mobile and it's not ideal but I still think it's better than having your users download half a megabyte of junk. I've been thinking about it although I haven't found a good alternative just yet. In any case I should point this out in the post. Thank you for your comment!
YouTube has an JavaScript-based embed API. In HTML, you can defer external JavaScript until the page has finished parsing. This way, the video player will only load after other parts of the page have been loaded first. While this won't decrease the amount of data that will get downloaded or prevent tracking by Google, it will allow people with a poor internet connection to comfortably view the page whilst the video player is taking its time to load in the background.
Here's a CodePen: codepen.io/jelle619/pen/yLBVyWY
If you don't like using this method, you could still make videos automatically play on browsers which, on the surface, don't seem to support
autoplay
. Some browsers have started blockingautoplay
because it allows web pages to play sound without the user's permission which can be unwanted. However, in many instances, browsers that do this will still allowautoplay
when the video has been muted.Might as well add the loading="lazy" attribute to the iframe (or even the IMG tag) for bonus lazy loading.
web.dev/native-lazy-loading
Great find! I didn't know this feature also supports
iframe
... 😅 I hope it will be introduced to other browsers besides Chrome soon.How can I handle the
autoplay
function since Chrome 66?I want the user to be able to click play just once. Unfortunately, this method requires
autoplay
be true. In order for autoplay to work properly,mute
also has to be set (mute=1
).But then the user will have to unmute once the video starts playing. How can I avoid that additional step?
Hi thanks for the post, great tips!
I have a question with this approach. So I'm having a problem with the video (it's my own video on youtube) that I embed on the website but it doesn't get tracked/showing up as external source pointing to the website in my Youtube Studio, do you happen to know what might be the issue?
Hai It really increased the loading speed of my blog posts , but its not fetching the thumbnail for related posts in my blogger blog , you can check the url here insidethemovie.com/2020/05/the-sec... so can you please tell me how to modify so that my theme code can fetch the thumb nail img. Also tell me how to make it responsive in desktop. Thank You
For related posts, you have to add ?rel=0 (if you want to show only your videos in suggestions.
And for playlists you will have to add &rel=0
See here
doveranalyst.com/2020/12/how-to-lo...