Create & customize transactional email templates

If you are editing a template created using the old template language (typically before September 21, 2018), please reference this guide or enable the new template language to use the functionality in this guide. 


You may use the SendinBlue Transactional (SMTP) platform to create and send your transactional emails, which are sent as a result of a contact's request or action (e.g. purchase confirmations, password resets, notifications, etc.).

Keep in mind that emails sent as part of an Automation workflow are also delivered via our Transactional platform.

This guide provides an overview of how to create and dynamically customize templates for use with the SendinBlue Transactional and Automation platforms.

Creating email templates

There are three methods for creating email templates in the SendinBlue interface.

  1. Drag & Drop Editor: Create a mobile-friendly (responsive) email template by dragging and dropping text blocks, images, buttons and other design elements to create a beautiful email.
  2. Rich Text Editor: Create simple text email templates using a WYSIWYG (What-you-see-is-what-you-get) editor.
  3. Paste Your Code: Paste your own HTML code, which should be created by a design professional.


Good to know: When sending a transactional email via the API, you may include the template HTML within the API call rather than saving the template in the SendinBlue interface.

Customizing email templates

You may customize email templates in several ways, all of which are powered by SendinBlue's New Template Language.

1. Add placeholders for recipient-specific content

These content placeholders are called variables. SendinBlue enables you to include three types of variables in your email templates:

2. Apply conditional logic to your template

You may control if and how content within your template is visible to recipients. This logic is established by applying tags around or within your content blocks. 

The if tag

Enables you to test if an expression is true and modify the email content based on the result. For example, "If the contact's attribute for favorite color is "blue", then show this content.

You can also manage more complex “if” statements that check for false values, multiple conditions, or multiple decision branches.

Using if, you may add or remove entire content blocks within a template or modify content within a block. For example, if your contact’s attribute for gender = male, you may wish to insert an image of men’s clothing.

Good to know: Try this simply and easily without any coding - use the Drag & Drop Editor's new display conditions tool. You may also view a detailed guide to using if here.

The for tag

Enables you to “loop” or iterate over items in a sequence and display them as a list in your email. This is very powerful when combined with your transactional parameters, and is also helpful when you are designing a template to hold an unknown number of items in a list.

for easily enables complex tasks, such as inserting a dynamic list of products into your template. 

Good to know: Try this simply and easily less coding - use the Drag & Drop Editor's new dynamic list tool. You may also view a detailed guide to using for here.

3. Modify variables within your template (filters)

You may change how a variable’s content is formatted in your template by applying filters:

Sending email templates

You may trigger your transactional email template to send using one of two methods.

  • Via the SMTP API (v3) using the “send a transactional email” call
  • Via SMTP relay. This method is used by many popular plugins to deliver emails created by the plugin using our SMTP platform.

To locate your API v3 key and SMTP credentials, navigate to the SMTP & API page inside your My Account area and click on the SMTP tab.


What's next?