Critical known issues
- Many v1 modules reference external CSS with techniques like require_css(get_public_template_url(). The get_public_template_url() function is no longer supported (see Restricted HubL section below). CSS should now be written into the module CSS in the code editor or linked via the Linked files section of the Inspector.
- Modules now have an immutable numerical ID. This allows module builders to change the name of a module without having to change references to the module in template code.
- Modules are designed to be self-contained and include all CSS text, JS text and file asset references.
- v2 Modules are wrapped in divs unlike v1 modules which are wrapped in spans.
- widget has been renamed to module in HubL for consistency with the UI. Both terms will continue to work, but module will be used in all documentation.
Additions to existing field types
New field types
|Number||A spinner style text field that only supports decimal or integer values.||
|Date||Selects a date. The value is stored as milliseconds since the epoch at midnight UTC on that date.||
|Date and Time||Selects a date and optional time. The value is stored as millseconds since the epoch in UTC.||
|CTA selector||Selects a CTA. Required for CTA module.||
|Blog selector||Selects a blog from the portal's list of blogs. Required for Blog Email Subscription, Post Listing and RSS Listing modules.||
|Tag selector||Selects a blog tag from the portal. Required for RSS Listing module.||
|Form selector||Selects a HubSpot form. Required for Form module.||
|Color selector||Picks a color.||
|Page selector||Selects a published website or landing page. Required for form module.||
|Workflow selector||Selects a HubSpot workflow. Required for form module.||
|Follow-up email selector||Selects a follow-up email.||
|Email address selector||Autofills with email addresses from portal users, but also allows any other valid email address. The value is a list of strings.||
|File selector||Similar to the image selector, but allows selection of other file types from File Manager. Useful for picking a PDF or image to link to. The picker attribute allows selecting files of certain types.||
|HubDB Table selector||Selects a published HubDB table to associate with this module.||
|Simple Menu||Allows creation of a local simple menu.||
|Menu selector||Selects a menu from the portal's menu.||
|Meetings selector||Selects a meeting from the portal's meetings||
|Logo Selector||Allows selection of a logo||
|Icon Selector||Allows selection of an icon||
To keep module rendering simple, the new module framework does not allow complex HubL such as nested modules and includes in the custom module source.
The following tags are not available:
These functions are not available:
Modules with these tags or functions will fail to publish.
Modules are allowed to contain supported HubL tags which render static versions of modules. However, the overrideable attribute is always considered False, even if specified as True in a module, as sub-modules generated by tags will not be editable in the content editors.
Several updates and additions have been made to module variables.
Existing variables that are no longer supported:
- module (also available as widget for backwards compatibility)
- name (formerly parent_custom_widget_name)