Skip to main content

Pro Modules

Lite Video Embed

πŸ‘‰ View module on HubSpot Marketplace

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 β€” 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
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
Sidebar input with YouTube/Vimeo URL.

Title

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

sidebar Title field
Sidebar Title field.

Thumbnail (optional)

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

sidebar Thumbnail upload
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
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
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
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
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
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
Style β†’ Border Radius grouped number inputs.

Alignment

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

Style β†’ Alignment select
Style β†’ Alignment select.

Looking to install this module?
πŸ‘‰ Get Lite Video Embed on the HubSpot Marketplace