Create programmable emails

With programmable emails, you can use advanced HubL syntax to personalize the content of your emails. Learn more working with CRM data in modules in HubSpot's developer documentation.

Understand limitations and considerations

• The data you can use in a programmable email depends on your HubSpot subscription:
  • If you have a Marketing Hub Professional account, you can render data from standard CRM objects, such as contacts, companies, and products.
  • If you have a Marketing Hub Enterprise subscription, you can include structured data sources such as HubDB tables and custom objects in programmable emails.
• The number of CRM functions that you can add to a programmable email depends on the number of recipients: 
  • Emails with 5 CRM functions can be sent to a maximum of 100,000 recipients. No more than 5 CRM functions can be added to a programmable email. 
  • Emails with 4 CRM functions can be sent to a maximum of 125,000 recipients.
  • Emails with 3 CRM functions can be sent to a maximum of 165,000 recipients.
  • Emails with 2 CRM functions can be sent to a maximum of 250,000 recipients.
  • Emails with 1 CRM function can be sent to a maximum of 500,000 recipients.
• Programmable emails must be sent at least an hour after any prior programmable emails.

Add programmable emails to modules or templates

In the design manager, you can create custom modules and custom coded templates that can be used for programmable emails.

Once you've created a custom module that supports programmable email, you can add that module to emails created in the drag and drop editor. 

Create a programmable email module

1. In your HubSpot account, navigate to Content > Design Manager.
2. In the left column, click the File menu and select New file. 
3. In the dialog box, click the dropdown menu and select Module, then click Next. 
4. In the Where would you like to use this module section, select the Emails checkbox.
5. In the File name field, enter a module name. 
6. Click Create. 
7. In the right column, toggle the Use module for programmable email switch on.

8. In the dialog box, review the sending limits, then click Agree and turn on. 

Create a programmable email coded template

1. In your HubSpot account, navigate to Content > Design Manager.
2. In the left column, click the File menu and select New file. 
3. In the dialog box, click the dropdown menu and select HTML + HubL, then click Next. 
4. Click the Template type dropdown menu and select Email.
5. In the File name field, enter a template name. 
6. Click Create. 
7. At the top of the coded template, add the following code to the section between <!-- and -->: isEnabledForEmailV3Rendering: true .

8. Finish making edits to the template, then click Publish changes in the top right.