Create and manage smart content rules

Smart content modules display different versions of your content based on viewer category. For example, you could create alternatives for visitors from a specific country or those viewing on a mobile device. 

Learn more about which modules are eligible for smart content in emails, blog posts, pages, and templates. 

Smart rule categories

You can base your smart rules on the following categories:

  • Country: display content to your viewer based on their country. The country is determined by the IP address of the visitor.
  • Device type: target visitors accessing your site via mobile, tablet, or desktop. The smart content tools analyze the user agent of your visitor’s browser to determine their device type. Since this can be changed manually on the device, accurate segmentation cannot be guaranteed.
  • Referral source: show visitors smart content based on how they found your site.
  • Preferred language: personalize your content based on the language set within the visitor's web browser. 
  • Contact list membership: show different content to visitors who are members of a specific HubSpot list. 
  • Lifecycle stage: display different content based on a visitor's Lifecycle stage property value.

Add smart content to your marketing emails (Marketing Hub Professional and Enterprise only)

You can add smart rules to the subject line and modules of marketing emails. Learn more about editing smart content in an email template

Add a smart rule to a subject line or module

  • In your HubSpot account, navigate to Marketing > Email.
  • Hover over your email and click Edit, or create a new email.
  • To add a smart subject line, navigate to the Settings tab. In the Subject line section, click Add smart rule.
  •  

add-smart-subject-line

  • To add a smart rule to a module, hover over the module, click the More dropdown menu, then click Add smart rule.
  • In the dialog box, click the Show different content based on dropdown menu and select Contact List Membership or Contact lifecycle stage. Because emails are sent to known contacts, you can't use smart content categories based on anonymous information like device type or referral source.
  • Click the dropdown menu and select the checkbox next to each list or lifecycle stage you want to target.
  • Click Create.

add-smart-rule-to-email

Manage your smart rules

  • In your HubSpot account, navigate to Marketing > Email.
  • Hover over your email and click Edit.
  • To manage a smart rule for a subject line, navigate to the Settings tab. In the Subject line section, click Manage smart rules. To add a new smart rule, click Add smart rule

manage-email-subject-line-smart-rules

  • To manage a smart rule for a module, hover over the module, click the More dropdown menu, and select Manage smart rules.

email-dnd-manage-smart-rules

  • In the right panel, click Add smart rule to add a rule, then click the dropdown menu and select a new smart rule category.
  • To delete a rule, click the trash icon delete next to the rule.
  • To change the rule type, delete all existing rules, then click the Show different content based on dropdown menu and select a different rule type.
  • When you've finished managing your smart rules, click Save.

Preview your email as a specific contact

When you're finished editing your smart rules, you can preview your email to see how it will appear to a specific contact. This allows you to see how multiple smart modules interact together. 
  • In your HubSpot account, navigate to Marketing > Email.
  • Hover over your email and click Edit.
  • In the top right, click the Actions dropdown menu and select Preview.
  • In the top left of the preview screen, click the Preview as a specific contact dropdown menu and select your contact.

All smart modules will display the version that applies to the contact you're testing. To preview a smart subject line, send a test email instead. 

Add smart content to a blog post or page

You can add smart content to any module on a blog post or page, except the Blog content module. Smart content based on contact list membership or lifecycle stage will only apply to tracked contacts

Visitors to your page who qualify for a smart rule category will see the content you’ve set for that rule. If a visitor qualifies for multiple categories, they will see the content set for the matching rule that appears first on the list. 

Add a smart rule to a blog post or page

add-new-smart-rule-on-a-page

  • In the right panel, click the Show different content based on dropdown menu and select a rule type. You can only select one rule type per module. 
  • Click Add smart rule.
  • Select a smart rule category. 
  • Click Add smart rule again to add additional rules based on the same rule type.
  • To change the rule type, click the trash icon delete next to each existing rule. Then click the Show different content based on dropdown menu and select a different rule type.
  • When you have added all smart rules, click Save. 
manage-smart-rules-1
  • In the sidebar editor, click the Editing for dropdown menu to switch between the default content and smart content for each rule.
  • Click Manage smart rules to add new rules or edit existing ones. 

smart-content-editing-options

Preview your page's smart rules

When you've selected a smart variation, the page editor will display the version of the page those visitors will see. All smart modules with the same rule will display content from that smart variation. You can check which variation you're viewing at the top of the editor in the Previewing smart variation banner. 

preview-smart-content

Add smart content in the design manager

In the layout editor, you can set a module to display smart content. This will automatically prevent users from editing this module in the content editor. 

Add smart content to a local module

  • In your HubSpot account, navigate to Marketing > Files and Templates > Design Tools.
  • In the finder, select the template.
  • In the layout editor, click the module.
  • In the inspector, click the More dropdown menu and select Make module smart.
HubSpot Help article screenshot
  • In the dialog box, click the Show different content based on dropdown menu and select a rule type. You can only select one rule type per module. 
  • Click the dropdown menu and select a smart rule category.
  • Click Create.
add-smart-rule-in-the-design-manager
  • In the Default content section of the inspector, edit your module's smart content. 
  • Click the Editing for dropdown menu to switch between the default content and smart content for each rule.
  • To add or change smart rules, click Manage smart rules

edit-smart-default-content

    • In the right panel, click Add smart rule to add additional rules based on the same rule type.
    • To change the rule type, click the trash icon delete next to each existing rule. Then click the Show different content based on dropdown menu and select a different rule type.
    • When you have finished editing your smart rules, click Save.

manage-smart-rules-in-the-design-manager-1

  • In the upper right, click Publish changes to take your changes live.

Add smart content to a global module


Please note: global modules support smart content, but modules inside global groups do not.

  • In your HubSpot account, navigate to Marketing > Files and Templates > Design Tools.
  • In the finder, select your global module.
  • In the inspector, click Edit global module.

edit-global-module-smart-content

add-smart-rule-in-global-content

  • In the right panel, click the Show different content based on dropdown menu and select a rule type. You can only select one rule type per module. 
  • Click Add smart rule.
  • Select a smart rule category. 
  • Click Add smart rule again to add additional rules based on the same rule type.
  • To change the rule type, click the trash icon delete next to each existing rule. Then click the Show different content based on dropdown menu and select a different rule type.
  • When you have added all smart rules, click Save. 
  • In the upper right, click Publish to [#] assets to take your changes live.