# Embedding videos in a page

{% hint style="info" %}
This feature is available on Beefree SDK [paid plans](https://developers.beefree.io/pricing-plans) only.
{% endhint %}

The Page Builder includes an expanded Video content block for optimized usage of videos on web pages. Videos are added inside an iframe via the HTML5 video tag.

There are multiple ways to add a video to a page built with Beefree SDK. Additional settings allow the video progress bar and loop playback to be turned on or off.

## **Embedded**

The Embedded mode allows video playback inside the page. It requires the URL of a video hosted on YouTube, YouTube Shorts, or Vimeo.

<figure><img src="/files/QXJjbKfK7nLJeAqU26vR" alt=""><figcaption></figcaption></figure>

## **Hosted video**

Same as the embedded option, but the URL provided must point to a self-hosted video in MP4 format. Settings for hiding controls and loop playback apply as well. Please note that the player interface your visitors will experience might slightly vary based on the browser they use.

<figure><img src="/files/n2nNuymZlxF6N1p9JDIr" alt=""><figcaption></figcaption></figure>

## **Thumbnail**

As a fallback, you may also use the video block for generating a thumbnail, the same way the block works when building emails. Just enter the URL for a video hosted on YouTube, YouTube Shorts, or Vimeo. A thumbnail linked to the video will be created. You may also style the overlay play icon.

<figure><img src="/files/dvLFmUaiqgtZ65OxZ2GP" alt=""><figcaption></figcaption></figure>

## Supported Video Sources

* YouTube (16:9 aspect ratio)
  * Public Videos
  * Unlisted Videos
  * Videos starting at a certain time
* YouTube Shorts (16:9 aspect ratio)
* Vimeo
  * Public Videos
  * Unlisted Videos
  * Cinemascope (21:9 aspect ratio)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.beefree.io/beefree-sdk/visual-builders/page-builder/embedding-videos-in-a-page.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.