Test your emails customized with Sendinblue Template Language

In this article, we will explain how to test your emails that were customized with the Sendinblue Template Language to make sure all content is displaying correctly.

Good to know

How to test an email

After creating an email template or campaign that contains contact attributes and transactional parameters placeholders, you may want to make sure they are correctly replaced by your contacts and events information.

💡 Good to know
If your email contains contact attributes placeholders, make sure that your Sendinblue contact list contains an email address and an attribute value for the contact you are using to test your email. If the attribute value is empty in your contact list, the value will either appear as blank like Hi ,or like Hi there,if you specified "there" as a fallback text.

To test your personalization, Sendinblue offers three options:

Send a test email

The Send a test option allows you to:

  • view how the content of your email is displayed in a recipient's inbox,
  • make sure the contact attributes are correctly replaced with the contact's information,
  • make sure the transactional parameters are correctly replaced with the event's information.

Limitations

Please note that the Send a test email option may not replace your placeholders depending on:

  • The type of email your are creating (campaign or template),
  • The type of placeholders you inserted in your email (contact attributes or transactional parameters).

 

Email campaign Email template

Contact attributes

If there is an existing email address and attribute value in your Sendinblue contacts list, the value will be replaced by contact's information.
Transactional parameters

The parameter values will be populated in your test email only in the following cases:
- the campaign was created using the API v3 call AND params were passed during the creation call, or
- the campaign was created in Sendinblue and params were passed as part of the Update Campaign API v3 call before the test email was sent.

The parameter values in your test email will appear as blank since params are populated at the time of sending when the API call is received or when the Automation workflow is triggered by an event.

 

 

 

How to send a test email

From the editor

To send a test email directly from the editor:

  1. Once you're done with the design of your email, click Action > Send test email (New Drag & Drop Editor) or Send a test email (Classic Drag & Drop Editor).
    mceclip0.png
  2. Enter the email address(es) of the contact(s) you want to send your test email to.
  3. Click Send test.
    2021-06-29_14-09-09.png

Your test email will be sent and you will be able to review it to make sure the placeholders are correctly replaced.

From the design review screen

To send a test email from the design review screen:

  1. Once you're done with the design of your email, click Continue (New Drag & Drop Editor) or Save & Quit (Classic Drag & Drop Editor).
  2. From the design review screen, click Send a test.
    mceclip2.png
  3. From here you have two options:
    • Enter the email address(es) of the contact(s) you want to send your test email to, or
    • Send the test email to your test list.
      2021-06-28_14-47-06.png
  4. Click Send a test.

Your test email will be sent and you will be able to review it to make sure the placeholders are correctly replaced.

Preview your email as a recipient

The Preview as a recipient option allows you to:

  • quickly view how the content of your email would be displayed to a specific recipient,
  • make sure the contact attributes are correctly replaced with the contact's information,
  • make sure the transactional parameters are correctly replaced with the event's information.

💡 Good to know
This option is only available from the New Drag & Drop Editor.

How to preview your email as a recipient

From the editor

To preview your email as a recipient from the editor:

  1. Once you're done with the design of your email, click Action > Preview as customer.
    mceclip6.png
  2. Search for the email address(es) of the contact(s) you want to preview your email as.
  3. If your email contains transactional parameters, paste your JSON data as it would appear in your API call.
    mceclip1.png
  4. Click Refresh preview.

Your email preview will appear and you will be able to review it to make sure the placeholders are correctly replaced.

From the design review screen

To preview your email as a recipient from the design review screen:

  1. Once you're done with the design of your email, click Continue (New Drag & Drop Editor) or Save & Quit (Classic Drag & Drop Editor).
  2. From the design review screen, click Preview and select Preview as a recipient.
    mceclip4.png
  3. From here, you have two options:
    • Test your contact attributes - In the Contact data tab, select a contact or enter their email address, or
      mceclip8.png
    • Test your transactional parameters - In the Dynamic data tab, paste your JSON data as it would appear in your API call.
      mceclip7.png
  4. Click Generate Preview.

Your email preview will appear and you will be able to review it to make sure the placeholders are correctly replaced.

Use an API call

To reliably test an email containing transactional parameters placeholders, we recommend creating the email template or campaign as you would normally do, and then sending the email template or campaign using the appropriate API call:

Your API call should then identify you as the recipient and include actual data for the transactional parameters included in your email template or campaign.

💡 Good to know
Correctly structured API calls will receive a 200-level response while erroneous API calls will receive an immediate 400-level response.

⏩ What's next?