Landing Pages

Embed an external media file in the rich text editor

Last updated: January 19, 2021

Applies to:

Marketing Hub  Professional, Enterprise
Service Hub  Professional, Enterprise
CMS Hub  Professional, Enterprise
Legacy Marketing Hub Basic

You can embed external media, such as a YouTube video, in a rich text module in your pages, blog posts, and knowledge base articles. You can also embed a video with a URL in a video module. Most media providers are supported.

To track interactions with a video on your page or blog post, learn how to add HubSpot Video to your content.

Please note: to add video to a page created with a starter template, use the video embed module.

Supported media types

The embed feature supports URLs in oEmbed format, which is common for most media types, including: YouTube, Spotify, and Vimeo. For a full list of supported media providers, see the oEmbed documentation.

Media files with additional security, such as a private YouTube video, are not supported.

Please note: if you get an error message when trying to embed your media file using a URL, try pasting the full embed code instead.

Embed an external media file in a rich text module

You can embed your media file with a file URL by following the steps below. As a shortcut, you can paste the URL of your embedded media directly in the rich text editor. The media file preview will populate automatically. 

  • In your HubSpot account, navigate to website pages, landing pages, blog, or knowledge base.
  • Hover over your page, post, or article, then click Edit.
  • In the content editor, click the rich text module where you're adding your media.
  • In the upper right section of the toolbar, click the Insert dropdown menu and select embed Embed.
  • In the Insert Embed dialog box, paste the media's URL or embed code. You'll see a preview of your embedded media file appear.
  • In the lower right, click Insert.

The easiest way to replace an embedded file is to delete the original, and repeat the steps above.

  • In the content editor, click the media file, then click Remove.
  • Repeat the steps above to embed a new file URL.

Learn more about how to edit the styling of embedded media.

Embed an external video in a video module 

You can also embed an external video on your page or a marketing email with a video module. This module is only available in the drag and drop page editor and the drag and drop marketing email editor

  • Add a video module to your page or marketing email.
  • In the left panel, under Video type select Embed.
  • Enter the Video URL.


Your video will be responsive by default. To customize the video's appearance:

  • Size: you can set an exact height and width for the video on all device types.
  • Maximum size: by default your video will not scale to be larger than its original size. You can customize the video to take up the full width of the device it's viewed on. Or set a custom maximum width and height for your video.
  • Custom thumbnail: to customize your video's thumbnail image, click Upload to select a new file from your computer, or click Browse images to select an image from your files tool.


  • Click Apply changes.

Please note: forms embedded in a rich text module using the embed option may not display in the page editor. To view the embedded form you can view the page preview.