Landing Pages

Add videos to your HubSpot content

Last updated: February 25, 2021

Applies to:

Marketing Hub  Professional, Enterprise
Service Hub  Professional, Enterprise
CMS Hub  Professional, Enterprise

You can add HubSpot Video to rich text modules in your pages, blog posts, and knowledge base articles. HubSpot Video is also supported in the video module available in the drag and drop page editor and drag and drop marketing email editor

To customize a visitor's experience with your HubSpot Video, you can display a CTA or a form before or after your video plays. It's possible to trigger a workflow based on the CTA clicks or form submissions from your video. If you have a Marketing Hub Enterprise subscription, you can report on video views as a data source in the custom report editor.

Please note: HubSpot Video is powered by Vidyard and is separate from the Vidyard for HubSpot integration, which is a separate paid feature for Vidyard customers. Videos from your Vidyard account do not appear in your files tool in HubSpot. 

Before you get started

  • This article covers how to add HubSpot Video in a rich text module or the video module in a page or marketing email. Learn more about how to embed external media in HubSpot.
  • To use HubSpot Video features, each user who wants to add videos to their content must enable HubSpot Video and accept the Vidyard terms of service in their own account.
  • Accounts have a limit of 250 videos for HubSpot-hosted content. If you integrate a paid Vidyard account, this limit is determined by the limits of your Vidyard subscription.
    • This limit does not apply to videos added to your one-to-one emails, templates, or sequences.
    • Only videos with the Allow embedding, sharing, and tracking switch toggled on in your files tool count towards the maximum limit of 250 videos.
    • New video files uploaded within the content editor will have Allow embedding, sharing, and tracking switched on automatically.

Add HubSpot Video to a video module (pages and marketing emails only)

HubSpot Video is supported in the video module in the drag and drop page editor and the drag and drop marketing email editor.

Since video is not supported on most email clients, videos added to your marketing emails will appear as a thumbnail image with a video player button. This thumbnail image links to a page where your email recipient can view your video.

Please note: landing pages created with a starter template don't support HubSpot Video, but you can embed an external video using a URL instead.

Add a video module in the drag and drop editor

To add a video module to your drag and drop email:

  • In your HubSpot account, navigate to Marketing > Email.
  • Click the name of the email you want to edit. 
  • In the left sidebar panel, click the Video module and drag the it into your email.

To add a video module to your drag and drop page:

  • In your HubSpot account, navigate to Marketing > Website Pages or Landing Pages.
  • Hover over the page where you want to add a video and click Edit. 
  • In the left sidebar panel, click the Video module and drag it into your page.


  • Click the video module in the page editor. 
  • In the left sidebar panel, select HubSpot video or the Embed option.
  • Add your video file for HubSpot video:
    • To select a video from your files tool, click Browse videos and select an existing video.
    • To upload a new video, click Upload and select a file from your computer.
  • Click Apply settings to add your video to your page.

Add HubSpot Video to a rich text module (pages, blog posts, knowledge base articles)

To insert a video into one of your HubSpot pages, blog posts, or knowledge articles:


  • If you haven't enabled your video features, you'll be prompted to enable them and accept the terms of service. In the dialog box, click Turn on new features.
  • In the Insert video panel, click a video to add it to your page.

Customize video styles

You can customize the styles applied to the video module on your layout. In both the video module and the rich text module, you can customize the play button that appears over your video thumbnail. 

Customize the styling of the video module on a page

  • Click the video module in the page editor.
  • In the left panel in the Options tab, you can customize the Maximum size for your video on this page. Keep in mind your video is always responsive, which means it will resize to fit the screen it's being viewed on.
  • Click Style options to customize the color of the play button that appears on your video. Enter a hex value or click the color picker to select a color.
  • Click the Styles tab to customize the alignment, spacing, and borders of your video module.

Customize the styling of the video module on an email

  • Click the video module within the email editor.
  • In the left panel, you can customize the Width and Height of the video in your email.
  • Click Style options to customize the play button that appears on your video.
  • To customize the video play button, enter a hex value or click the color picker to select a color.
  • To customize the size of the play button, enter a value or click and drag the slider to the desired value. 

  • If desired, you can click to toggle the Show as maximum width on mobile devices switch on to ensure your video is always full-width on a mobile device.
  • If desired, customize the alignment and spacing around the video module on your email.

Customize the video player styles in a rich text module

To customize the video player in a rich text module:

  • Click the video in the rich text module, then click Edit.
  • In the Video options dialog box, click the Style tab. Here you can customize the size, alignment, and spacing of your video. 
  • To customize the color of the video player button, click the Player color color bubble or enter a hex value.


Customize video details for search engines

You can update your video file details within the content editor. This will update the video details within the files tool and across any content where the video is published.

  • To edit the video within a rich text module:
    • Click the video within your content, then click Edit.
    • In the Video options dialog box, click Edit video details


  • To edit the video details in a video module:
    • Click the video on your page or email layout.
    • In the left panel, scroll down to the Video details section and click Edit.


  • In the right panel, you can customize the following:
    • Thumbnail image: this image may appear in a preview for your video in search engine results. You can upload a JPG, PNG, or GIF file.
    • File name: enter a file name for your video.
    • Title: write a short, descriptive title for your video.
    • Description: write a short description of your video to help search engines understand your video's content.
    • Meta tags: this term helps search engines understand what your video is about. You can use your topic or subtopic keywords for your meta tags.
  • Click X in the upper left to apply your changes to the video file.

Add a form or CTA overlay to your video (pages, blog posts, and knowledge base articles only)

You can add a CTA or form overlay on top of your HubSpot Video. This overlay can be displayed before your video starts playing or after the video ends. 

There are a few limitations to the CTAs and forms you can add this way: 

  • You'll need to create a new CTA or form.
  • An overlay CTA will be a button style and will not support a custom image.
  • An overlay form can only collect the First Name, Last Name, and Email fields.
  • Overlay forms do not trigger form notifications. They will create or update a contact if the Email field is included or you have allowed forms to create contacts without an email address

To add an overlay to your video:

  • Within the content editor, click your video then click Edit.
  • In the Overlay section, select Call-to-action or Form.
  • Click Create CTA/form.
  • In the right panel, click Create new, then create your new overlay content:
    • Create a button CTA, then click Save
    • Customize your form's name, font style, header message, and inline thank you message. After customizing your form, click Add form.
  • Display time: select to show overlay content right before your video starts to play, or right after your video finishes playing.


Analyze video performance 

After adding a video to your HubSpot page, blog post, knowledge article, or email, you can analyze the video's performance through metrics like view count and video retention. View these metrics on the content details page, in custom reports, and on contact timelines. 

Please note: video activities on the contact timeline and custom reports are only available for HubSpot videos added to HubSpot content. External video files embedded with a URL won't be tracked the same way.

Video views on blog posts, pages, knowledge base articles, and emails

  • Navigate to your blog, landing pages, website pages, knowledge base or email dashboard.
  • In your content dashboard, click the name of a blog post, page, or email to view its Performance details. If there's more than one HubSpot video on the page you're analyzing:
    • Click the Video dropdown menu in the upper left.
    • Select the video you want to analyze. 
  • Analyze your video plays: 
    • Video views: the number of times your video loaded on your page in a visitor's browser.

    • Video retention: a measure of which parts of your video content were played. This gives you a better idea of whether viewers are skipping ahead or replaying your video at a specific moment.


Video views on a contact record

To see video views on a contact record:

  • In your HubSpot account, navigate to Contacts > Contacts.
  • Click the name of a contact.
  • To filter contact activity by video views, click Filter activity.
  • Select the Video views checkbox.


Video views in custom reports (Marketing Hub Enterprise only)

In the custom report builder, you can select Video as a data source in custom reports. This data is only available for HubSpot Video shared on a HubSpot-hosted page, blog post, email, or knowledge base article.

Users with Account Access permissions can enable this data source in your Tracking & Analytics settings:

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, click Tracking & Analytics > Attribution.
  • In the Interaction Types section, click to toggle the Viewed video switch on.
  • Click Save.