If you’ve tried making your HubSpot pages more dynamic with videos, podcasts, or social embeds—only to wrestle with broken links or misaligned layouts—you’re not alone. Many marketers understand that media-rich pages drive deeper engagement, but embedding that content the right way in HubSpot often trips teams up.
Maybe your team spends hours tinkering with embed codes. Or maybe you’ve seen perfectly good content break on mobile. These frustrations usually come down to misunderstanding where and how HubSpot handles third-party media.
This guide walks you through embedding external media files on HubSpot pages. You’ll learn which tools to use, where mistakes typically occur, how to set things up correctly, and how to track performance once it’s live.
Enhance Page Engagement with Third-Party Media Embeds
Embedding external media in HubSpot means placing third-party content—such as YouTube videos, Google Maps, or LinkedIn posts—directly on your HubSpot site or landing pages using either embed code or native modules.
HubSpot gives you a few ways to embed this kind of content:
- The Rich Text module lets you drop in HTML in the source code view
- The Video module parses media URLs like YouTube or Vimeo
- Custom HTML modules give you full control for more advanced use cases, like widgets or scripts
Embedding this way keeps your media hosted offsite, which helps your HubSpot pages load faster while also saving storage space within your CMS. Even better, HubSpot can still track how users interact with embedded media by syncing activity to its built-in CRM.
If you’re on HubSpot’s Content Hub or Marketing Hub Professional or above, you can make your media even more effective using smart content or responsive design tools that adjust embeds for different segments and screen sizes.
How It Works Under the Hood
HubSpot uses modular blocks and drag-and-drop editing to build pages. When you embed external media, HubSpot pulls in data using either an iframe or oEmbed snippet and then renders it live using its rendering engine. Here’s how it plays out technically:
- You drop your embed code (like an iframe) into a module
- HubSpot stores that in your page’s HTML
- On load, HubSpot’s server delivers the structure, then the visitor’s browser requests the media from its original host
- The third-party source delivers the media in real time
You’ll usually be working with one of these:
- An embed code, often generated by platforms like YouTube or Google Maps
- A direct URL, when using modules that support auto-parsing
- An iframe snippet, offering greater embed flexibility
A few helpful customization options:
- Responsive embeds: Make sure the media adjusts to screen size; essential for mobile users
- Lazy loading: Prevent the media from loading until the user scrolls into view, improving performance
- Alignment and spacing: Customize layout in the page editor without extra CSS
Knowing this behind-the-scenes process makes it easier to spot and fix issues like broken embeds, misaligned videos, or code that doesn’t display properly.
Main Uses Inside HubSpot
Video tutorials on service pages
Embedding product or service videos is one of the most effective ways to enhance clarity and reduce bounce rates. It’s also a smart way to turn passive visitors into high-intent leads.
Example: Your sales team records a product tutorial and uploads it to Vimeo. You drop that video on a key landing page using HubSpot’s Video module. You monitor play counts on Vimeo but gauge page behavior—such as form submissions—in HubSpot analytics. The two together paint a complete picture of engagement.
Podcast or webinar replays
Adding podcasts or on-demand webinars to blog posts or resource hubs keeps your audience on-page and reduces off-site drop-off.
Example: You want to embed a SoundCloud podcast into your latest blog article. Using a Custom HTML module, you paste in the iframe so it looks native. You track email traffic to the article using HubSpot UTM links, which helps you attribute performance to a specific channel.
Interactive social or form widgets
Sometimes it’s not just media you want to embed—it’s tools like social posts, signup forms, or chat popups. HubSpot can handle those too, with just a bit more precision.
Example: You’re launching a partner campaign and want to embed a Google Form and a recent LinkedIn post into a microsite page. You use the Rich Text module’s source option to drop in both snippets. Your external platform logs the responses, while HubSpot tracks page views and interactions.
Common Setup Errors and Wrong Assumptions
Point: Inserting raw external code in restricted areas
Why it happens: Not all modules accept every type of code. HubSpot blocks certain scripts unless placed into a Custom HTML module.
Fix: Use the Custom HTML module for anything script-heavy, or talk to your admin if permission errors pop up.
Point: Skipping responsive embed settings
Why it happens: Fixed width and height make your video or form look great on desktop—but break on mobile.
Fix: Use the “Make module responsive” checkbox or add CSS rules like max-width: 100% manually.
Point: Using share links instead of embed codes
Why it happens: Copying a URL instead of the full embed from platforms like YouTube causes nothing to render.
Fix: Make sure you’re pasting the full embed snippet, not just a share link or video URL—unless you’re in a module that supports auto-parsing.
Point: Adding unsupported scripts from outside platforms
Why it happens: Some third-party services run JavaScript that HubSpot flags for security reasons.
Fix: Stick to iframe embeds when possible, or ask your CMS administrator to whitelist trusted services.
Step-by-Step Setup or Use Guide
Before diving in, make sure you have either Content Editor or Administrator rights in HubSpot. Also, confirm that your external media allows embedding (some platforms require special settings), and grab the correct code or link.
- Log in to your Marketing Hub or CMS Hub portal
- Go to Marketing > Website > Website Pages or select Landing Pages
- Choose the page you want to edit and click Edit
- Inside the editor, pick your module area. Use Rich Text, Video, or Custom HTML depending on the content
- For videos, use the Video module and paste the external URL. HubSpot auto-embeds supported links like YouTube or Vimeo
- For other media, choose Custom HTML:
- Drag the module into place
- Paste your full embed code from the third-party source
- Adjust dimensions within the code block if needed
- Use Preview to test on desktop, tablet, and mobile
- Hit Publish once everything looks correct
Tips to optimize:
- Place media above the fold to boost visibility
- Write descriptive alt text or captions for accessibility
- Rename your module in the editor so it’s easier to manage
- Use caching and compression tools if your media platform supports it, to improve load speed
Measuring Results in HubSpot
Embedding is only half the job—you also need to know if it’s working. HubSpot gives you several native tools to track how embedded media affects user behavior:
- Page views: Use Traffic Analytics to compare views before and after embedding
- Time on page: Longer times usually indicate users are engaging with your media
- CTA or form submissions: Drop a call-to-action or form near the media to see if it boosts conversions
- Clicks on embedded content: Use tracking URLs or CTAs nearby to monitor interaction
- Campaign attribution: Tag embedded content to campaigns to measure its direct impact through HubSpot’s Campaigns tool
If you’re running sales ops or RevOps workflows, you can also link this engagement back to individual contacts through custom properties, UTM links, or activity logs—assuming your external media platform plays nicely with event tagging.
Then pull all of that into HubSpot dashboards to review which media investments actually drive deals forward or improve lead quality.
Short Example That Ties It Together
A marketing team wants to repurpose its latest product webinar by placing the on-demand video on its HubSpot resource hub. The content lead grabs the embed code from Vimeo, opens the page inside HubSpot, and drops the video into a Custom HTML module within the main content section. They check “responsive” for mobile friendliness, preview it, and hit publish.
A week later, HubSpot analytics showed a noticeable bump in time on page and CTA conversions. Tagged under a specific campaign, the marketers now have data showing the webinar replay didn’t just look good—it actually generated qualified leads.
How INSIDEA Helps
HubSpot’s flexibility is powerful, but integrating embedded content, page flow, and performance tracking can be tricky. That’s where INSIDEA comes in.
Our team helps you embed third-party media without hiccups, format your pages so everything fits cleanly, and connect the dots with CRM data and reporting. Whether you’re launching a new video series or embedding complex widgets, we ensure your strategy aligns with what the CMS can actually do.
INSIDEA’s HubSpot services cover:
- Onboarding: Set up your portal and templates with embedded content in mind
- Ongoing management: Organize your modules and layout for maximum visual consistency
- Automation support: Trigger workflows based on user behavior with embedded assets
- Analytics alignment: Track what matters with dashboards connected to your media strategy
To find out how INSIDEA can simplify your HubSpot media setup or campaign workflow, book a call with one of our certified HubSpot experts today!
