Opening Section
If you’ve ever tried embedding a HubSpot form inside a Smart Rich Text Module, you’ve likely run into limits that interrupt your workflow.
You want personalized content that’s easy to update, but HubSpot’s default modules don’t always give you the design freedom your pages need.
Maybe your content team wants to swap forms for different audiences, or your dev team wants to avoid building a new custom module every time.
This becomes especially crucial when launching a campaign that requires rapid changes across landing pages or blog layouts.
You’re trying to stay flexible without sacrificing performance or brand consistency, and that’s exactly where smart modules come into play.
In this guide, you’ll learn how to safely embed a form inside a Smart Rich Text Module, how HubSpot handles this behind the scenes, common mistakes to avoid, and how to measure performance once your page goes live.
Using Smart Rich Text Modules for Dynamic Content in HubSpot
A Smart Rich Text Module in HubSpot is more than just a content box. It’s a dynamic content area that supports HTML, images, smart rules, and inline elements like forms.
You’ll typically use it inside blogs, landing pages, or website templates that require flexible formatting.
Smart Behavior:
“Smart” refers to its ability to show different content to people based on who they are. You can segment by contact lists, lifecycle stage, device type, or other HubSpot criteria without involving a developer.
Embedding a form in this module means pasting either the HubSpot form’s embed code or shortcode directly into the rich text editor.
Typically, forms are added using a dedicated Form Module. This approach lets you place a form inline with text, buttons, and CTAs, keeping everything visually and structurally aligned.
Where You’ll Work:
- Forms Tool: Marketing > Lead Capture > Forms
- Smart Content Controls: Inside the Rich Text Module
- Page Editor: Drag-and-drop or coded editor where modules live
Because HubSpot’s CRM connects directly to these elements, embedded forms can auto-fill known contact details and respond dynamically when smart rules are applied.
How It Works Behind the Scenes
Once you paste a HubSpot form embed into a Smart Rich Text Module, HubSpot processes smart rules first.
Based on visitor data, it selects the matching content version and renders the corresponding rich text variation. The embedded form is then loaded dynamically via an iframe generated by the embed script.
What You Need in Place:
- Published Form: With a valid Form ID
- Smart Content Access: Permissions enabled
- Published Page or Template: That supports smart modules
When configured correctly, the form appears inline and respects the rule conditions defined for that audience.
What You Can Control:
- Smart Rules: Based on lists, lifecycle stages, or devices
- Form Settings: Progressive fields, required inputs, redirects
- Styling: Theme-level or page-level CSS adjustments
Important detail: HubSpot applies only the first matching smart rule. If multiple rules qualify, only the top one loads. Rule order matters, so structure them carefully.
Why Marketers and Web Teams Use This Setup
Teams use embedded forms in Smart Rich Text Modules to capture leads adaptively without creating or maintaining multiple templates.
Contextual Forms Within Landing Pages
This setup is especially useful when targeting multiple audiences from a single landing page.
Example Use Case:
One page serves several segments. Webinar attendees see a “Request Demo” form, while cold traffic sees a “Download Guide” form, all within the same content block.
Updates stay centralized, layouts remain consistent, and content aligns naturally with the surrounding copy.
Personalized Blog Lead Capture
Content teams often use Smart Rich Text Modules near the end of blog posts.
Smart Targeting:
- Returning subscribers see advanced resources
- New readers see a basic subscription form
Smart rules tied to lifecycle stage or contact properties handle the switching without requiring new blog templates.
Context-Aware Customer Feedback Forms
Service teams embed feedback forms inside knowledge base articles or gated portal content.
Conditional Display:
Forms appear only for customers or change messaging based on account type, product usage, or renewal stage.
A user reading an upgrade article might see a “Was this helpful?” form directly in the content, without leaving the page.
Common Pitfalls That Waste Time
Using Only Part of the Form Embed Code:
If you paste only the iframe and skip the script tag, the form will not load correctly. Always copy the full embed code from the form builder.
Skipping the Default Smart Content Version:
Every Smart Module needs a fallback. Always configure the default content first before adding smart variations.
Assuming Styles Will Carry Over:
Embedded forms do not inherit styles from standard Form Modules. Styling must be handled through your theme, custom CSS, or design manager.
Ignoring Mobile Behavior:
Narrow rich text containers can break form layouts on mobile. Always preview embedded forms on smaller screens and adjust spacing or containers as needed.
Step-by-Step: How to Embed Your Form
Step 1: Create Or Select Your Form
Go to Marketing > Lead Capture > Forms. Create or choose a form and publish it.
Step 2: Copy the Embed Code
Open the form, click Embed, and copy the full code block. Do not remove any part of it.
Step 3: Open the Page Editor
Navigate to Marketing > Website > Website Pages or Landing Pages and open the target page.
Step 4: Locate Or Add the Smart Rich Text Module
Select the Rich Text Module and enable Smart Content if it is not already active.
Step 5: Paste the Embed Code
Switch to Source Code view and paste the embed code exactly where the form should appear.
Step 6: Add Smart Variants
Create variations for each smart rule. You can embed different forms or adjust surrounding copy. Keep the default version intact.
Step 7: Test Your Page
Use Preview mode and simulate different contacts or devices to confirm correct form loading.
Step 8: Publish And Monitor
Publish the page after validation. HubSpot will serve the correct form based on the smart rule conditions.
Measuring Impact With HubSpot Reporting
After embedding forms inside Smart Rich Text Modules, tracking performance is critical.
Form Analytics:
Go to Marketing > Lead Capture > Forms to review submission rates for each embedded form.
Page Analytics:
Open the page’s Performance tab to see which smart variants trigger and how each version converts.
Contact Attribution:
Use Reports > Analytics Tools > Attribution to connect form submissions to lifecycle changes or revenue impact.
Custom CRM Dashboards:
Create dashboards that map form submissions to contact owner, source, or pipeline stage to see how smart content affects outcomes.
Short Example That Brings It All Together
A CMS manager runs a “Request Consultation” campaign across service pages.
Instead of creating multiple modules, a single form is embedded in a Smart Rich Text block.
New visitors see the consultation form. Returning customers see a short feedback form in the same location.
After launch, HubSpot analytics show that 35 percent of consultation requests come from that Smart Module.
No extra templates were created, and every submission synced cleanly with CRM records.
How INSIDEA Helps
Configuring Smart Rich Text Modules and embedded forms can look simple until real-world requirements add complexity.
INSIDEA supports teams that want flexibility without breaking structure.
How We Support You:
- HubSpot Onboarding: Smart content and form tracking setup
- HubSpot Management: Ongoing alignment across data, modules, and automation
- Automation Strategy: Connecting embedded forms to the right workflows
- Reporting: Dashboards that show real funnel impact
- CMS Flexibility: Page and module designs that scale across use cases
If you are planning to hire HubSpot experts who understand CMS behavior, form logic, and CRM alignment, INSIDEA brings that experience together.
Our HubSpot consulting services help teams build adaptable content systems that stay clean, measurable, and easy to manage over time.
Building high-converting content in HubSpot does not require custom code for every update.
When Smart Rich Text Modules and embedded forms are set up correctly, your pages stay flexible, structured, and ready to convert where it matters most.
