Last modified: August 22, 2025
Below, learn about the modules that you can use when building email templates. These modules are separate from default web modules, which can be used to build website pages, blog posts, and blog listing pages. Many of the modules below were released to replace usage of default web modules in emails, such as the email_logo module replacing the logo module. If your email templates are still using the web versions of these modules, learn how to update your email templates to use email-specific modules instead. To view a default module’s code, you can view and clone the module within the @hubspot folder of the design manager, or fetch it by its path locally using the HubSpot CLI.
design-manager-default-modules

​
Email blog post filter

A version of the blog post filter module for emails. 
{% module "post_filter" path="@hubspot/email_post_filter" %}
ParameterTypeDescriptionDefault
select_blogBlogThe blog to display posts from.
filter_typeChoiceType of filtering links to show. Choices include:
  • tag
  • month
  • author
tag
order_byChoiceOrdering for the values of filter links. Choices include:
  • post_count
  • name
post_count
list_titleTextAn H3 heading."Posts by Tag"
max_linksNumberNumber of filter links to show. Leave blank to show all.5
expand_link_textTextText to display if more than the max_links value to display are available."See all"

​
Email blog post listing

A version of the blog post listing module for emails. 
{% module "post_listing" path="@hubspot/email_post_listing" %}
ParameterTypeDescriptionDefault
select_blogBlogThe blog to display posts from.
listing_typeChoiceThe type of listing for your posts. Choices include:
  • recent: most recent.
  • popular_all_time: most popular of all time.
  • popular_past_year: most popular the past year.
  • popular_past_six_months: most popular the past six months.
  • popular_past_month: most popular the past month.
recent
list_titleTextAn H3 heading."Recent Posts"
max_linksNumberMaximum number of posts to display.5

​
Email Call-to-Action

A version of the Call-to-Action module for emails. 
{% module "cta" path="@hubspot/email_cta" %}
ParameterTypeDescription
guidStringGlobally Unique Identifier of the CTA.

​
Email header

A version of the header module for emails. 
{% module "email_header" path="@hubspot/email_header" %}
ParameterTypeDescriptionDefault
valueTextText for the heading."A clear and bold header"
header_tagChoiceChoose a heading level. Choice include h1 through h6.h1

​
Email HTML

Raw HTML module for emails. 
{% module "raw_html_email" path="@hubspot/raw_html_email" %}
ParameterTypeDescriptionDefault
htmlHTMLHTML block. \n Add custom HTML to your email.\n

​
Email image

Image module for emails. 
{% module "image_email" path="@hubspot/image_email" %}
ParameterTypeDescriptionDefault
imgImageImage to be used for the email.
linkTextOptional link for the image.
alignmentChoiceAlignment of the image. Choice include:
  • left
  • center
  • right
center

​
Email linked image

A version of the image module for emails. 
{% module "email_linked_image" path="@hubspot/email_linked_image" %}
ParameterTypeDescriptionDefault
imgImageImage object containing:
  • src: image url
  • alt: alt text for image
  • loading: lazy loading options include:
    • disabled
    • lazy
  • width: px value
  • height: px value
{ "src": "https://static.hubspot.com/final/img/content/email-template-images/placeholder_200x200.png", "alt": "placeholder_200x200", "loading": "disabled", "width": 200, "height": 200 }
linkTextOptional link for the image.
targetBooleanOpens link in a new tab.false
A version of the logo module for emails. 
{% module "logo" path="@hubspot/email_logo" %}
ParameterTypeDescriptionDefault
imgImageImage object containing:
  • override_inherited_src: override the default logo from settings
  • src: image url
  • alt: alt-text for logo
{ "override_inherited_src": false, "src": null, "alt": null }
linkTextOptional link for the logo. If no url is specified, your logo will link to your primary domain.
open_in_new_tabBooleanOpens link in a new tab.false
suppress_company_nameBooleanHide the company name when an image is not selected.true
heading_levelChoiceChoose a heading level when no image is selected and suppress_company_name equals false. Choices include h1 through h6.h1

​
Main email body

The main body module for emails. 
{% module "email_body" path="@hubspot/email_body" %}
ParameterTypeDescriptionDefault
htmlRich TextDefault content for the email body. Supports HTML. See below for this field’s default value.
<!-- Default html field value -->
<p>Hi {{contact.firstname}},</p>\n<p>Describe what you have to offer the customer. Why should they read? What did you promise them in the subject line? Tell them something cool. Make them laugh. Make them cry. Well, maybe don't do that...</p>\n<p>Use a list to:</p>\n<ul>\n<li>Explain the value of your offer</li>\n<li>Remind the reader what they’ll get out of taking action</li>\n<li>Show off your skill with bullet points</li>\n<li>Make your content easy to scan</li>\n</ul>\n<p><a href=\"http://hubspot.com\">LINK TO A LANDING PAGE ON YOUR SITE</a> (This is the really important part.)</p>\n<p>Now wrap it all up with a pithy little reminder of how much you love them.</p>\n<p>Aw. You silver-tongued devil, you.</p>\n<p>Sincerely,</p>\n<p>Your name</p>

​
Office location information

Office location information footer for emails (CAN-SPAM compliant). 
{% module "email_can_spam" path="@hubspot/email_can_spam" %}
ParameterTypeDescription
htmlRich TextPopulates required CAN-SPAM information for emails including business address and unsubscribe/preferences links.See below for this field’s default value.
<!-- Default html field value -->
<p id=\"footer\" style=\"font-family: Geneva, Verdana, Arial, Helvetica, sans-serif; text-align: center; font-size: 12px; line-height: 1.34em; color: {{ secondary_font_color }}; display: block;\">{{ site_settings.company_name }}   {{ site_settings.company_street_address_1 }}  {{ site_settings.company_street_address_2 }}  {{ site_settings.company_city }}  {{ site_settings.company_state }}   {{ site_settings.company_zip }}   {{ site_settings.company_country }} <br><br> You received this email because you are subscribed to {{ subscription_name }} from {{ site_settings.company_name }} . <br><br> Update your <a target=\"_blank\" href=\"{{ unsubscribe_link }}\" style=\"text-decoration: underline; whitespace: nowrap; color: {{ secondary_font_color }};\" data-unsubscribe=\"true\">email preferences</a> to choose the types of emails you receive. <br><br>  <a target=\"_blank\" href=\"{{ unsubscribe_link_all }}\" style=\"text-decoration: underline; whitespace: nowrap; color: {{ secondary_font_color }};\" data-unsubscribe=\"true\">Unsubscribe from all future emails</a>  </p>

​
Email one line of text

A version of the text module for emails. 
{% module "text" path="@hubspot/email_text" %}
ParameterTypeDescriptionDefault
valueTextAdd your text to this parameter."Some additional information in one line"

​
Email section header

A version of the section header module for emails. 
{% module "section_header" path="@hubspot/email_section_header" %}
ParameterTypeDescriptionDefault
headerTextSection header content."A clear and bold header"
heading_levelChoiceHeading level for the header. Choices include h1 through h6.h1
subheaderTextSubheading paragraph text for the section."A more subdued subheader"

​
Email social sharing

A version of the social sharing module for emails. 
{% module "social_sharing" path="@hubspot/email_social_sharing" %}
Note: The variable social_link_url in the default column below is the same value as the link parameter.
ParameterTypeDescriptionDefault
linkTextThis is the destination link that will be shortened for easier sharing on social networks.
facebookObjectObject containing:
  • enabled: boolean to enable social item
  • custom_link_format: custom URL for socials sharer URL
{ "enabled": false, "custom_link_format": "http://www.facebook.com/share.php?u={{ social_link_url }}" }
twitterObjectObject containing:
  • enabled: boolean to enable social item
  • custom_link_format: custom URL for socials sharer URL
{ “enabled”: false, “custom_link_format”: “https://twitter.com/intent/tweet?original_referer=\{\{ social_link_url }}&url={{ social_link_url }}&source=tweetbutton&text={{ social_page_title|urlencode }}” }
linkedinObjectObject containing:
  • enabled: boolean to enable social item
  • custom_link_format: custom URL for socials sharer URL
{ "enabled": false, "custom_link_format": "http://www.linkedin.com/shareArticle?mini=true&url={{ social_link_url }}" }
pinterestObjectObject containing:
  • enabled: boolean to enable social item.
  • custom_link_format: custom URL for socials sharer URL.
  • pinterest_media: image object including:
    • src: image URL.
    • alt: alt-text for the image.
{ "enabled": false, "custom_link_format": "http://pinterest.com/pin/create/button/?url={{ social_link_url }}&media={{ pinterest_media }}", "pinterest_media": { "src": "", "alt": null } }
emailObjectObject containing:
  • enabled: boolean to enable social item
  • custom_link_format: custom URL for socials sharer URL
{ "enabled": false, "custom_link_format": "mailto:?subject=Check out {{ social_link_url }} &body=Check out {{ social_link_url }}" }

​
Email subscription preferences

Module for displaying email subscription preferences. 
{% module "email_subscriptions" path="@hubspot/email_subscriptions" %}
ParameterTypeDescriptionDefault
headerTextH1 heading.header
subheader_textRich TextSupplemental text for your H1 heading."If this is not your email address, please ignore this page since the email associated with this page was most likely forwarded to you."
unsubscribe_single_textTextPreference selection help text."Uncheck the types of emails you do not want to receive:"
unsubscribe_all_textTextUnsubscribe all help text."Or check here to never receive any emails:"
unsubscribe_all_unsubbed_textTextUnsubscribe all help text for a currently unsubbed user."You are presently unsubscribed from all of our emails. Would you like to receive our emails again?"
unsubscribe_all_optionTextLabel for unsubscribe all option."Unsubscribe me from all mailing lists."
button_textTextUpdate preferences button text."Update email preferences"
resubscribe_button_textTextResubscribe button text."Yes, resubscribe me!"

​
Email subscriptions confirmation message

Confirmation of email subscription changes. 
{% module "email_subscriptions_confirmation" path="@hubspot/email_subscriptions_confirmation" %}
ParameterTypeDescriptionDefault
headerTextH1 heading.
subheader_textRich TextSupplemental text for your H1 heading."If this is not your email address, please ignore this page since the email associated with this page was most likely forwarded to you."
unsubscribe_all_successTextMessage on unsubscribe."You have successfully unsubscribed from all email communications."
subscription_update_successTextMessage on subscription update."You have successfully updated your email preferences."

​
Email unsubscribe (backup)

Supported in pages, blog posts, and blog listings. 
{% module "email_simple_subscription" path="@hubspot/email_simple_subscription" %}
ParameterTypeDescriptionDefault
headerTextH1 heading."Email Unsubscribe"
input_help_textTextH3 heading for help text."Your email address:"
input_placeholderTextPlaceholder content for the input field."email@example.com"
button_textTextText to display on the unsubscribe button."Unsubscribe"

​
Email video

A video module for emails. 
{% module "video_email" path="@hubspot/video_email" %}
ParameterTypeDescriptionDefault
video_typeChoiceType of video. Choices include:
  • embed: embed code from an external source.
  • hubspot_video: HubSpot hosted video.
embed
hubspot_videoVideo PlayerHubSpot hosted video. Used when video_type equals hubspot_video.
embedObjectObject containing source_type. Only value of oembed is available.{ "source_type": "oembed" }
oembed_thumbnailImageOverride oembed thumbnail image when video_type equals embed and embed_field equals oembed.{"size_type": "exact"}
style_optionsObjectObject containing:
  • play_button_color: color hex code.
  • play_button_scale: number 0-100
{ {"play_button_color":{ "color":"#2f4254", "opacity":100},"play_button_scale" : 30} }
alignmentChoiceAlignment of video. Choices include:
  • left
  • center
  • right
center