Skip to content
Landing Pages

Add videos to your HubSpot content

Last updated: October 24, 2022

Applies to:

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

With HubSpot video, you can upload videos to the files tool, then add them to pages, marketing emails, blog posts, and knowledge base articles. 

You can insert HubSpot videos in the video module in drag and drop marketing emails and drag and drop areas on pages. HubSpot video is also supported in rich text modules on pages, blog posts, and knowledge base articles. 

To customize a visitor's experience with your HubSpot video, you can display a CTA or form before or after your video plays. In account with an Enterprise subscription can display the CTA or form at any point during the video and prevent visitors from skipping it. 

Please note: this article deals with using videos in pages, posts, articles, and marketing emails. Learn more about adding videos to conversations, one-to-one emails, templates, and sequence emails.  

Before you get started

  • This article covers how to add video files uploaded to HubSpot to your HubSpot content. To add an external video from a URL or embed code, learn more about embedding external media in HubSpot.
  • Each browser supports different file types and, in some cases, will download the video file instead of playing it in the browser. Videos uploaded as .mp4 files are supported in most browsers and will play in the browser.
  • Each video is subject to the limitations of the files tool.
  • For each video in the files tool, you can turn on or off advanced features. New video files uploaded within the content editor will have advanced features switched on automatically.  Differences between videos with advanced features turned on and off are outlined below: 
  • You can add additional capacity for videos with advanced features with the video limit increase add-on.  
  Advanced features turned on Advanced features turned off  

Add videos to HubSpot content in video modules 

Not available

 

Track video performance in HubSpot

Available for pages, blog posts,  and knowledge base articles

Not available

 

Include a form or CTA with the video

Available for pages, blog posts,  and knowledge base articles

Not available

 

Generate a direct link to the video

Not available

 

Limit in the files tool

250 videos

Unlimited videos

 

Add videos to emails

HubSpot video is supported in the video module of the drag and drop 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 will link to a page where your email recipient can view your video, which will be hosted on the primary domain for the web versions of emails. 

  • In your HubSpot account, navigate to Marketing > Email.
  • Click the name of the email.
  • In the sidebar editor, click the Video module and drag it into your email.
  • In the Video type section, select HubSpot video.

add-hubspot-video-to-email-1

    • To select a video from the files tool, click Browse videos and select an existing video's thumbnail image.
    • To upload a new video, click Upload and select a file from your computer. Then click the video's thumbnail image.
  • To resize your video, in the sidebar editor, enter a width or height. 
  • To customize your video's information, in the Video details section, click Edit

Please note: changes made to your video details will apply everywhere the video is used in HubSpot's content tools.


    • In the right panel, click Change thumbnail image to change the preview image for your video.
    • Click the slider and drag it to a specific point in the video or click Upload custom image to add a new image from your computer. Under the thumbnail image, click Done.
    • Enter a file name, title, and/or description. This will help search engines understand your video's content.
    • Click Done.

edit-your-video-details

  • To edit the appearance of your video's play button, click Style options.
    • To customize the play button's color, enter a hex value or click the color picker to select a color. 
    • To customize the play button's size, enter a pixel value or click the slider and drag it to a new position. Your play button's live preview may take a few seconds to update. 
email-video-module-style-options
  • To ensure your video displays at full width on mobile devices, select the Show as maximum width on mobile devices checkbox. Videos will never display at a width larger than their original dimensions. 
  • To move the video to the right or left, click the Alignment dropdown menu and select Left, Center, or Right.
  • To add space on the sides of your video, click to toggle the Padding switch on. 
    • Select the Apply to all sides checkbox to apply the same padding to all sides of the video.
    • Enter pixel values for padding in the Top, Bottom, Left or Right text fields.

add-padding-to-video-module

Add videos to pages, blog posts, and knowledge base articles

Videos can be added to blog posts, pages, and knowledge base articles in rich text modules. Drag and drop areas of pages also support adding videos to video modules. 

Insert a video in a rich text module on a page, blog post, or knowledge base article 

HubSpot videos can be added to rich text modules alongside text, images, links, or other content.  

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
    • Blog: In your HubSpot account, navigate to Marketing > Website > Blog.
    • Knowledge Base: In your HubSpot account, navigate to Service > Knowledge Base.
  • Hover over your page, post, or article and click Edit.
  • In the content editor, click the rich text module.
  • Click the Insert dropdown menu, then select Video > HubSpot video.
  • In the right panel, select a video to insert:
    • To insert an existing video from the files tool, click the video's thumbnail image.
    • To insert a new video, click Upload videos and select a video from your computer. Then click the video's thumbnail image.

add-video-to-content

You can customize your video's appearance in the rich text toolbar: 
  • To edit the color of your video's play button, click the backgroundColor player color dropdown menu and select a color. To enter a hex value or RGB color value, navigate to the Advanced tab. 
  • To adjust your video's position within a block of text, click the inline alignmentalalignment icons. Click the full width icon fullWidth to ensure your video displays at full width on mobile devices.  
  • To resize your video, enter pixel values for the width and height. 
  • To edit the padding around your video, click the Spacing dropdown menu and enter pixel values around the edges of the image icon.

edit-rich-text-video

You can also add a form or CTA overlay to display before or after your video plays:
  • Within the content editor, click your video, then click the edit edit icon.
  • In the pop-up box, click the CTA or form dropdown menu and select Call-to-action or Form.
  • To insert a CTA: 
    • Click Select CTA.
    • To create a new CTA, click Create new in the right panel. Create the CTA, then click Save
    • In the right panel, select a newly created CTA or an existing CTA, then click Insert
  •  To insert a form:
    • Click the Form dropdown menu and select a form
    • To create a new form or edit an existing form before selecting it, click Create or edit. This will open the forms tool in a new tab. 
  • By default, the overlay will appear after the video finishes. To change the overlay's display options:
    • If you do not have an Enterprise subscription, select a display time for your overlay. You can display your form or CTA before your video starts to play, or right after your video finishes playing. 
set-display-options-for-video
    • If you have an Enterprise subscription: 
      • Click Edit next to Display options in the pop-up box.

add-overlay-to-video-in-hubspot

      • In the right panel, click the Display time dropdown menu and select a time. If you select a custom time, you can specify the time by clicking the circle below the video and dragging it to the correct position, or entering a time in the Selected display time field. 
display-options-for-video
      • To stop visitors from skipping the overlay, click the Skip option dropdown menu and select Don't allow visitors to skip form/CTA. By default, visitors will be be allowed to skip the overlay. 

Insert a video in a video module on a page

HubSpot video is supported in the video module added to a drag and drop area on a website or landing page. Landing pages created with starter templates don't support HubSpot video, but you can embed an external video instead.

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
  • Hover over the page and click Edit. 
  • In the sidebar editor, click the Video module and drag it onto your page.

add-video-to-a-page-1

  • In the content editor, click the video module.
  • In the sidebar editor, under Video type, select HubSpot video.
  • Select a video file to add to your page:
    • To select a video from the files tool, click Browse videos and select an existing video's thumbnail image.
    • To upload a new video, click Upload and select a file from your computer. 
  • Select your video's maximum size: 
    • Original size: the video will not display larger than its original size.
    • Full width: the video will take up the full width of the device it's viewed on.
    • Custom: the video will not exceed a specific width and height set in the sidebar editor. Enter pixel values for these dimensions in the in the Width and Height text fields
  • In the Video details section, click Edit to customize your video's information:

Please note: changes made to your video details will apply everywhere the video is used in HubSpot's content tools.

    • In the right panel, click Change thumbnail image to change the preview image for your video.
    • Click the slider and drag it to a specific point in the video or click Upload custom image to add a new image from your computer. Under the thumbnail image, click Done.
    • Enter a file name, title, and/or description. This will help search engines understand your video's content.
    • Click Done.

edit-your-video-details

  • In the CTA or form section, you can add a form or CTA overlay to your video: 
    • Click to expand the CTA or form section. 
    • Click the CTA or form dropdown menu and select an overlay type
    • To insert a form, click the Form dropdown menu and select a form, or click Create new to create a new form in the forms tool
    • To insert a CTA:
      • Click Select CTA.
      • To create a new CTA, click Create new in the right panel. Create the CTA, then click Save
      • In the right panel, select a newly created CTA or an existing CTA, then click Insert
    • If you do not have an Enterprise subscription, select a display time for your overlay. You can display your form or CTA before your video starts to play, or right after your video finishes playing.

set-overlay-display-time-in-non-enterprise-hubspot-account

    • If you have an Enterprise subscription:
      • Click Edit next to Display options in the sidebar editor.

edit-enterprise-account-cta-or-form-options

      • In the right panel, click the Display time dropdown menu and select a time. If you select a custom time, you can specify the time by clicking the circle below the video and dragging it to the correct position, or entering a time in the Selected display time field. 

display-options-for-video

      • To stop visitors from skipping the overlay, click the Skip option dropdown menu and select Don't allow visitors to skip form/CTA. By default, visitors will be be allowed to skip the overlay. 
  •  
  • To edit your play button's color, click Style options, then enter a hex value or click the color picker and select a color.

edit-your-play-button-s-color

Analyze video performance (pages, blog posts, and knowledge base articles only)

After adding a video to your HubSpot page, blog post, or knowledge base article, 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. You can also filter for media interactions in lists and workflows. 

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

Video views in page performance 

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
    • Blog: In your HubSpot account, navigate to Marketing > Website > Blog.
    • Knowledge Base: In your HubSpot account, navigate to Service > Knowledge Base.
  • Click the name of a post, page, or article to view its Performance details.
  • If there's more than one HubSpot video on the page, in the upper left, click the Video dropdown menu and select a video
  • Analyze your video plays: 
    • Video views: the number of times your video loaded on your page in a visitor's browser.

      video-views-on-performance-page
    • Video retention: a measure of which parts of your video content were played. 

      video-analytics

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, then select the Media plays checkbox.

filter-for-media-plays

Video plays in custom reports (Marketing Hub Professional and Enterprise only)

Using the custom report builder, you can create reports to analyze video plays:

  • In your HubSpot account, navigate to Reports > Reports.
  • In the upper right, click Create custom report.
  • In the left sidebar menu, click Custom Report Builder.
  • To use custom behavioral events as your primary data source, click the Primary data source dropdown menu, then select Media

    media-plays-custom-report-builder0
  • If you want to use media plays as a non-primary source, you can select Media from the Marketing section.
     
    media-secondary-source-custom-report-builder0
  • Continue building your report

Video plays in attribution reports (Marketing Hub Enterprise only)

By default, video plays will be included in revenue attribution reports. If this setting has been turned off, users with Account Access permissions can turn this data source on again in settings:

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, click Tracking & Analytics > Attribution. This setting will only appear for users with Account Access permissions.
  • In the Interaction Types section, click to toggle the Media plays switch on.
  • Click Save.
  • In the dialog box, review the change, then click Save & start reprocessing.

Your existing reports will begin to reprocess to include video plays. This may take up to two days, depending on the amount of data in your HubSpot account. HubSpot will send you an email confirmation once your reports are finished reprocessing.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.