Adding a picture or video is the easy part. Making it load efficiently and understandable to every visitor is the real goal.
What You Need to Know
A poster image is a preview of a video before playback begins. Choose a useful frame that represents the content instead of a decorative picture that misleads visitors.
Try the Example
Take a look at the example. We’ll explain the important lines right below it.
<video controls width="640" poster="images/video-cover.jpg" preload="metadata">
<source src="media/lesson.mp4" type="video/mp4">
This browser cannot play the video.
</video>Let’s Read the Code
- poster: Poster provides a preview picture for a video.
- <video>: The video element creates a video player and can include alternative formats.
- <source>: A source points to a media file or image choice with a type or other condition.
- controls: Controls asks the browser to provide its native audio or video player controls.
Read the named elements and attributes together. They explain how the browser connects this feature to the rest of the page.
What Happens in the Browser?
The paths shown here refer to files in your own example project. Put real images and recordings in those locations before expecting them to load.
What if the resource is missing? Test the page with the media path temporarily broken. The surrounding text should still explain the important idea, and controls should remain understandable. This is especially important for slow connections and accessibility.
Your Turn
Replace the media filename with your own local recording and check playback, controls, and fallback content.
Common Beginner Mistakes
- Forgetting that captions are stored in a separate timed-text file, not generated by the video tag.
- Always check keyboard access, readable alternatives, and any missing files; a perfect player layout does not guarantee accessible content.
Key Takeaways
- A poster image is a preview of a video before playback begins.
- poster: Poster provides a preview picture for a video.
- If the resource cannot load, users still need enough text to understand what was meant to be there.