Email Template

Use Twilio Engage to build personalized email templates to store and use throughout marketing campaigns.

Build an email template from scratch using the Drag and Drop Editor or the HTML Editor. Include personalized content in the subject line, preview text, and email body to engage with users based on their profile traits and actions.

Build an Email template

Navigate to Engage > Content and use the Email Templates page to preview and edit existing templates.

To configure an email template, click Create Template.

1. Select Email, and click Configure.

1. Configure the email template.
   1. Add a template name for internal reference.
   2. Add an internal description.
   3. Enter the sender email address. You can optionally include profile traits.
      • Emails can only be sent from verified domains.
   4. Enter the sender name.
   5. Indicate if you want replies sent back to the initial sender. If not, add a “reply to” email and name, or include profile traits.
   6. Add email addresses to receive a blind carbon copy of your email.
   7. Add preview text and the subject line. Use merge tags to personalize the email template with real-time profile traits.
2. Select the design method to build your email template:
   • Drag and Drop Editor is a drag and drop WYSIWYG tool with customizable content blocks.
   • HTML Editor contains both a code and visual editor from a single view. This editor provides complete HTML editing access with error flagging.
3. Design the email template, then click Create Email Template.

Test the Email template

You can send test emails before you include a template in marketing campaigns.

1. Select the email template you want to test on the Templates screen.
2. From the Template Settings page, click Test email.
3. If your template has profile traits, enter a trait value for the test email. This ensures that your merge tags work as expected.
   • To test a default value, leave the profile traits field blank. Default values must be assigned in your merge tags. For example, loyal customer would be the default for the following merge tag: {{profile.traits.first_name | default: "loyal customer"}}.
   • To test traits with arrays, you must input the array in JSON format. For example, [“item1”, “item2”] or [{“itemName”: “shoes”}]. If you don’t use JSON format for arrays in the test message side sheet, your template might not render as expected.
4. Enter recipient email addresses for the test message.
   • Profiles that you send test messages to must have a userId in Segment.
5. Select Send test email.

Dynamic sender using merge tags

Engage supports dynamic sending using merge tags. Personalize email content by adding real-time profile traits in merge tags to the following fields:

• Subject line
• Preview text
• Message body
• From sender
• Reply to email

As you configure the template, click Merge Tags and select the profile traits to include. Engage inserts the merge tags based on cursor placement.

The following table contains a description and some best practices for all fields in the email template. Asterisks indicate required fields.

You can also add merge tags in the heading or body text as you design an email with the Drag and Drop or HTML editors. Engage supports liquid templating to create dynamic content in the email design editor.

Use liquid statements with an image URL

If you’re using the image content module in the Drag and Drop Editor, you can’t use liquid statements in the Image URL field. To use liquid statements with an image, Segment recommends using an HTML block with the following syntax:
<img src=“{{profile.traits.imageLink | default: '<insert your default URL here>'}}”, where profile.traits.imageLink is an example profile trait representing personalized image links for each recipient.

Include unsubscribe and manage preference links

When you build an email template, you’ll need to include links that your customers can access to unsubscribe and manage their email preferences. You’ll find both in the Special Links dropdown menu of the Insert/Edit link window.

Unsubscribe links

When you build email templates, it’s your responsibility to include an unsubscribe link in your message. Add unsubscribe links to an email template from the Drag and Drop or HTML editors.

When a recipient clicks on an unsubscribe link, they’ll see a confirmation page and the recipient’s subscription state is updated.

Learn more about User Subscriptions in Twilio Engage.

Manage preference links

The manage preference link lets your customers opt in and out of email groups on an individual basis instead of unsubscribing from all your campaigns.

For more information, see subscription groups.

Arrays and objects in Broadcasts

Segment doesn’t support profile traits in object and array datatypes in Broadcasts, but you cam use them in Journeys.

Next steps

• View some email deliverability tips and tricks from SendGrid.

• You can also use the Templates screen in Engage to build SMS templates.

FAQs

Do updates to an email template automatically apply to Journey steps using it?

When you add a template to a Journey step, it becomes a copy specific to that step. Changes made to the original template won’t update the Journey version, and edits made in the Journey step won’t affect the original template. This keeps your Journey changes separate while preserving the original for reuse.