# Embed Videos

Great Docs supports embedding YouTube, Vimeo, Loom, and local video files with responsive layouts and automatic lazy loading.


# Quick Example

To embed a YouTube video, use the following syntax in any `.qmd` page:

```
{{< video https://www.youtube.com/watch?v=wo9vZccmqwc >}}
```

Here's a live example:


# An error occurred.


Unable to execute JavaScript.


The video is responsive by default, and YouTube embeds use a lightweight thumbnail placeholder that loads the player only when clicked.


# Local Video Files

For short screen recordings, reference a local `.mp4` file:

```
{{< video assets/demo.mp4 >}}
```

> **Note: Note**
>
> Keep video files small. Git repositories aren't ideal for large binary files. For longer recordings, consider uploading to YouTube or Vimeo and embedding from there.


# More Options

For full details on aspect ratios, start times, accessibility labels, Vimeo, Loom, cross-referencing, and performance tips, see the [Videos](../user_guide/videos.qmd) page in the User Guide.