---
title: "Lite Video Embed"
description: "Setup and usage instructions for the Lite Video Embed module in HubSpot CMS. Includes sidebar configuration steps, player options, style tab, privacy mode, and optional Video SEO schema."
url: "https://freshjuice.dev/docs/modules/lite-video-embed/"
---
Documentation

# Lite Video Embed

[View module on HubSpot Marketplace](https://app.hubspot.com/l/ecosystem/marketplace/modules/lite-video-embed-module-by-freshjuice?utm_source=freshjuice.dev)

The **Lite Video Embed** module allows you to embed YouTube or Vimeo videos in a performance-optimized way. All settings are available in the **sidebar panel** when editing a page in HubSpot.

[View module preview](https://demo.freshjuice.dev/modules/lite-video-embed) — this is a HubSpot landing page showing the module in action. You can use it to test performance with tools like PageSpeed Insights.

---

## Content tab (video setup)

### Video Provider

Select your video platform (**YouTube** or **Vimeo**).

![sidebar showing Video Provider dropdown](https://freshjuice.dev/_astro/video-provider.-Wz5vOsr_Z1Lkgfm.webp)

Sidebar showing Video Provider dropdown.

### Video ID / URL

Paste the full video link or just the video ID.

-   Example YouTube: `https://www.youtube.com/watch?v=dQw4w9WgXcQ`
-   Example Vimeo: `https://vimeo.com/861680818`

![sidebar input with YouTube/Vimeo URL](https://freshjuice.dev/_astro/video-url.C9ms_2kD_ZXRXLA.webp)

Sidebar input with YouTube/Vimeo URL.

### Title

Accessible label shown for the video. Default: **Play Video**.

![sidebar Title field](https://freshjuice.dev/_astro/video-title.DQqaD0xO_JWy9K.webp)

Sidebar Title field.

### Thumbnail (optional)

Upload a custom thumbnail or leave blank to use the platform’s preview.

![sidebar Thumbnail upload](https://freshjuice.dev/_astro/video-thumbnail.BKdBp6nF_Z1gi6Hb.webp)

Sidebar Thumbnail upload.

## YouTube Player Setting (shown only when YouTube is selected)

-   **Show controls** — display YouTube UI (playbar, buttons).
-   **Show Fullscreen Button** — toggle fullscreen icon visibility.
-   **Start** — start playback at a specific second (e.g., `30` → starts at 0:30).
-   **End (optional)** — stop playback at a specific second (must be greater than Start).
-   **Loop** — loop the video when it ends.
-   **Access the YouTube Iframe Player API** — enable programmatic control (play/pause/seek/events).
    
    >   
    > Enabling the JS API disables Privacy mode for YouTube (loads from `youtube.com` and may set cookies).
    

![sidebar YouTube settings toggles/inputs](https://freshjuice.dev/_astro/video-youtube-settings.BE9MAU8G_ndAdA.webp)

Sidebar YouTube settings toggles/inputs.

## Vimeo Player Settings (shown only when Vimeo is selected)

-   **Show title** — display the video title.
-   **Show byline** — display the creator byline.
-   **Show portrait** — display the channel avatar.
-   **Loop** — loop the video when it ends.
-   **Accent color** — set the player’s accent color (e.g., `#ff9900`). Can inherit from theme’s primary color.
-   **Private token / query (optional)** — append a private token or query (e.g., `h=abc123`) for unlisted/private videos.

![sidebar Vimeo settings with color picker and toggles](https://freshjuice.dev/_astro/video-vimeo-settings.DQOqPdAl_Z1hEQVK.webp)

Sidebar Vimeo settings with color picker and toggles.

## Advanced options

Expand the **Advanced** group in the sidebar:

-   **Custom CSS Class** — add extra classes for targeting or styling.
-   **Privacy mode** — YouTube no-cookie embed / Vimeo limited tracking.
-   **Enable Video SEO Schema** — injects structured data (VideoObject) into the page.

![sidebar Advanced toggles expanded](https://freshjuice.dev/_astro/video-advanced.D_nTIfWE_9ka5g.webp)

Sidebar Advanced toggles expanded.

#### Example SEO schema output

When enabled, the page will include JSON-LD markup like this:

```
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "VideoObject",
    "name": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
    "description": "“Never Gonna Give You Up” was a global smash on its release in July 1987.",
    "thumbnailUrl": ["https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"],
    "uploadDate": "1987-07-27T00:00:00+00:00",
    "inLanguage": "en",
    "embedUrl": "https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ",
    "potentialAction": {
      "@type": "WatchAction",
      "target": "https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ"
    }
  }
</script>
```

## Style tab

### Max Width

Set a maximum width for the video block (in pixels), e.g., **1280**, **960**, or **800**.

![Style → Max Width numeric input](https://freshjuice.dev/_astro/video-style-max-width.BKieGTHS_NTxW2.webp)

Style → Max Width numeric input.

### Aspect Ratio (Vimeo only)

Choose the aspect ratio for **Vimeo** videos (YouTube uses fixed 16:9):

-   **16:9** — widescreen (default)
-   **4:3** — standard
-   **1:1** — square
-   **9:16** — vertical/portrait

![Style → Aspect Ratio select for Vimeo](https://freshjuice.dev/_astro/video-style-aspect-ratio.Djt6XcHN_Z20qB3F.webp)

Style → Aspect Ratio select for Vimeo.

### Border Radius

Round the container corners (pixels per corner):

-   **Top Left**, **Top Right**, **Bottom Left**, **Bottom Right**

![Style → Border Radius grouped number inputs](https://freshjuice.dev/_astro/video-style-border-radius.BPwgemZ2_Zdj8kz.webp)

Style → Border Radius grouped number inputs.

### Alignment

Align the embed within its container: **Left**, **Center** (default), or **Right**.

![Style → Alignment select](https://freshjuice.dev/_astro/video-style-alignment.B06VCne9_hubd5.webp)

Style → Alignment select.

---

Looking to install this module?  
[Get Lite Video Embed on the HubSpot Marketplace](https://app.hubspot.com/l/ecosystem/marketplace/modules/lite-video-embed-module-by-freshjuice?utm_source=freshjuice.dev)