Skip to content

Creating a transactional email template

Build the email in HubSpot's drag-and-drop editor, keep it transactional, and add it in Settings.

Templates are ordinary HubSpot marketing emails. You design them in HubSpot’s drag-and-drop email editor, just like a newsletter — but you never send them from HubSpot. Instead, the Send transactional email action uses the email’s subject and content, fills in the recipient’s details, and sends it.

Transactional Email renders the email itself, so it supports HubSpot’s standard drag-and-drop modules but not custom or Marketplace modules. Every template version also passes an automatic content review before it can send.

  • Access to HubSpot’s marketing email editor.
  • A clear purpose for the email: a receipt, a subscription notice, an account notification. Promotional content fails the content review.
  1. Create an email. In HubSpot, go to Marketing → Email, click Create email, and choose an Automated email with the drag-and-drop editor. Or click Create a template in HubSpot in Settings → Templates, which opens that editor directly.
    • Automated is the better choice: its Personalize button offers tokens from the workflow’s record (a deal, ticket, order, custom object, and so on) as well as contact and company tokens.
    • A Regular email’s Personalize button offers only contact and company tokens. It works fine for emails that need nothing else, and you can still type other tokens by hand.
  2. Pick a simple layout. Start from a basic layout with one or two columns.
  3. Write the subject line. Every template needs a subject. You can use tokens in it, such as Your receipt, {{ contact.firstname }}.
  4. Build the content with supported modules — rich text, images, buttons, dividers, and spacers. See Supported email modules.
  5. Add personalization. Type tokens such as {{ contact.firstname }} or {{ company.name }} where the recipient’s details belong. See Personalizing emails with tokens.
  6. Keep it transactional. Leave out discounts, promotions, product announcements, and newsletter content. Links to the customer’s account, your help center, and your legal footer are fine.
  7. Save the email, and publish it only if it’s Automated. An Automated email can be added whether it’s a draft or published. A Regular email must stay a draft: publishing one sends it to a list. Keeping an Automated email as a draft has one advantage: you can delete HubSpot’s unsubscribe footer, which HubSpot requires before it publishes an Automated email.

Next, a Super Admin adds the email in Settings → Templates. See Adding a template.

  • Adding the template checks its modules and starts the content review. If it can’t be sent, it shows as Incompatible in Settings → Templates. See How the transactional content review works.
  • Once it’s compatible and approved, it appears in the Email template dropdown of the Send transactional email action.
  • Edits reach your sends within about 15 minutes, or right away if a Super Admin clicks Refresh in Settings → Templates. See Refreshing a template after editing.
  • Keep one email per purpose (“Order receipt,” “Renewal reminder”) and give it a name your team will recognize in the dropdown.
  • Transactional emails don’t carry an unsubscribe footer. If the email has HubSpot’s footer module, Transactional Email leaves out its unsubscribe and preference links. In a draft you can delete the module and type your company address or legal text into a rich text module instead.
  • Every email gets a plain-text version automatically.