Creating email templates

To create an email template

1. Open the Amazon Pinpoint console at https://console.aws.amazon.com/pinpoint/.

2. In the navigation pane, choose Message templates.

3. Choose Create template.

4. Under Channel, choose Email.

5. Under Template details, for Template name, enter a name for the template. The name must begin with a letter or number. It can contain up to 128 characters. The characters can be letters, numbers, underscores (_), or hyphens (‐).

6. (Optional) For Version description, enter a brief description of the template. The description can contain up to 500 characters.

7. Under Email details, use the following options to specify the content for messages that use the template:

   • For Subject, enter the text that you want to display in the subject line of the message.

   • For Message, enter the content that you want to display in the body of the message.

     Tip

     For the message body, you can enter the content by using either the HTML or Design view. In the HTML view, you can manually enter HTML content, including formatting, links, and other features that you want to include in the message. In the Design view, you can use a rich text editor to enter the content. Use the formatting toolbar to apply formatting and add links and other features to the content. To switch views, choose HTML or Design from the view selector above the message editor.

     You can also include personalized content in the subject and body of the template. To do this, add message variables that refer to specific attributes that you or Amazon Pinpoint created, such as an attribute that stores a user's first name. By using message variables, you can display different content for each recipient of a message that uses the template. To use a message variable, choose the name of an existing attribute from the Attribute finder. Amazon Pinpoint creates a message variable for the attribute and copies it to your clipboard. Paste the variable in the location that you want. For more information, see Adding personalized content to message templates.

8. Note

   You must set up an email orchestration sending role before you can use email headers. For more information, see Creating an email orchestration sending role in Amazon Pinpoint.

   Under Headers, choose Add new headers, to add up to 15 headers for the email message. For a list of supported headers see Amazon SES header fields in the Amazon Simple Email Service Developer Guide.

   • For Name, enter the name of the header.

   • For Value, enter the value of the header.

   (Optional) To add a One-click unsubscribe link, to a promotional email, add the following two headers:

   1. Create a header with List-Unsubscribe for Name and set Value to your unsubscribe link. The link must support HTTP POST requests to process the recipients unsubscribe request.

   2. Create a header with List-Unsubscribe-Post for Name and set Value to List-Unsubscribe=One-Click.

9. (Optional) Under Plain text version, enter the content that you want to display in the body of messages that use the template and are sent to recipients whose email applications don't display HTML content.

10. If you added personalized content to the template by using message variables, specify a default value for each variable. If you do this, Amazon Pinpoint replaces the variable with the value that you specify, if a corresponding value doesn't exist for a recipient. We recommend that you do this for each variable in the template.

    To specify default values for variables, expand the Default attribute values section. Then enter the default value that you want to use for each variable. If you don't specify a default value and a value doesn't exist for a recipient, Amazon Pinpoint does not send the message.

11. When you finish entering content and settings for the template, choose Create.