Developer Announcements

jmclaren
HubSpot Employee
HubSpot Employee

Email and the web are different, default modules are splitting to reflect this

The text below is a copy of a post on the developer changelog. If there are inconsistencies between this version and the one on the changelog the one on the changelog takes precedence.

HubSpot has several default modules that can be used in both CMS Hub and Marketing Hub emails. The code and features supported in web browsers and in email clients differ significantly. To better support the experience in both places we'll be splitting these modules into 2 versions: One for email, one for web and landing pages.

jmclaren_0-1696609784808.gif

 

What's happening?

We're splitting HubSpot default modules that currently support being used in both emails and web pages, into an email module, and a web page focused module. Custom created modules will not be affected. Splitting these modules lays a foundation enabling HubSpot to deliver updates to these modules that are better optimized for where they'll be used.

The following default modules are affected:

These modules will remain the same for website pages, for email an email clone of the module is now available.

The only change to the paths of the module is that they are now prefixed email_. Example: @hubspot/email_text.

Existing email definition

{%raw%}

{% module "email_template_logo" path="@hubspot/logo" link="test-link.html" label="Logo" %}

Updated email definition

{% module "email_template_logo" path="@hubspot/email_logo" link="test-link.html" label="Logo" %}

{% endraw %}

See our documentation on this change for more examples.

All email templates with module definitions associated with modules part of this migration will are now showing warnings. In order to resolve the warning, users need to update module path to use email module path.

 

For modules using id's instead of paths you will see:

jmclaren_2-1696609785299.png

 

We've provided a list of these modules so you can convert to using the correct module's module_id instead.

When is it happening?

The email clone versions of the modules are available in HubSpot accounts now.

Rolling out to accounts now - all new email templates, and edits to existing email templates will throw a warning when using an incorrect version of a module.

On January 5th any new email templates, and edits to existing email templates will error and prevent publishing, when an incorrect module path is used. We will around this same time roll out an update that will automatically change modules in existing templates to use the new paths.

Questions or comments? Join us below.

Jon McLaren

Sr. CMS Developer Advocate

Get started developing on the HubSpot CMS Developer Changelog
How to optimize your CMS Hub site for speed

If my reply answered your question, please mark it as a solution, to make it easier for others to find.

0 Antworten

0 Antworten

Noch keine Antworten

Auf diesen Beitrag hat noch niemand geantwortet. Es lohnt sich aber, gelegentlich wieder vorbei zu schauen und nachzusehen, ob jemand eine Antwort gepostet hat – oder um eine eigene Lösung zu posten!

Auf Beitrag antworten

Hilfe gefällig? Weitere Infos in unseren Community-Richtlinien