Email Notification Tutorial

An email notification is an HTML or plain-text email that you send to registered users. Email notifications appear in recipients' email inboxes.

See the Email Notifications message type reference for options and settings in these tutorial.

Resources:

 Tip

You can save this message as a Composer Favorite — a reusable message with preset settings and content. You can use Composer Favorites instead of recreating commonly used messages. See: Use Composer Favorites.

  1. Open your messaging project, then click Create and select Message.
  2. (Optional) Add a message name and/or flag the message as a test.
    1. Click in the header.
    2. Enter the name.
    3. Enable the Test toggle.
    4. Click outside the box to close it.
  3. Under Channels, select Email.
  4. Select your desired message audience, then click Content in the header to move on.
    • All Users: Sends the message to your entire audience.
    • Target Specific Users: Create a recipient group based on segmentation data. See: Target Specific Users.
    • Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Test Groups.
    • Upload Users: Upload a list of users just before sending the message. Select this option if you want to include merge fields in your message. See: Upload Users.
     Important

    If you are using merge fields in your HTML, you must select Upload Users.

  5. If you chose Upload Users in the Audience step, first choose Custom HTML. Otherwise, you will not see this selection screen.
  6. Enter the HTML and plain text versions of your message in the Content pane.
     Note

    • For commercial messages, both HTML and plain text content must include an Unsubscribe link. The Content step is considered incomplete until a link is provided or the message is designated as transactional in the Settings pane.
    • Merge fields can be included in HTML and plain text content if you chose Upload Users in the Audience step.

     Tip

    When you combine SMS, Email, or Open Channels with additional channels, the content is configured on separate tabs.

  7. Complete the Settings fields and selections, then click Delivery in the header to move on.
    • From Name and From Email: The name and email address your message is from.
    • Reply To Email: The address your audience can send replies to.
    • Transactional An email sent in response to a user's interaction with your app or website — receipts, shipping notifications, password reset notifications, etc. : Set if your message is a direct response to user interactions with you — receipt for a purchase, shipping updates, etc. Otherwise, your email (or email template) is Commercial A promotional email sent to an audience of users who have opted to receive promotional marketing messages from you. and requires an unsubscribe link.
    • Bypass Status: Send the message to audience members even if they have opted out of transactional messages. Use this setting for business critical emails only.
  8. Select a delivery type and Optional Features, then click Review in the header to move on.
  9. Review the device preview and message summary. Click the arrows to page through the various previews. The channel and display type dynamically update in the dropdown menu above. You can also select a preview directly from the dropdown menu.To make changes, click the associated step in the header, make your changes, then return to Review.
  10. Click Send Message or Schedule Message. If you chose Upload Users in the Audience step, click Upload & Send, then:
    1. Click Choose File, and select the file that contains your list of users. Uploaded merge field names will be verified against the merge fields set in the Content step.
    2. Click Send Message.

Send a Templated Email Notification

You must use the Upload Users option to send a notification using a template. You should have the user list that you want to upload ready before you begin this tutorial.

If your template includes handlebars, your user list can also include the data that you want to pass into your message when you upload users. For more information, see Dynamic Content and Merge Fields.

 Tip

To use email templates for commercial messages, you must include an unsubscribe link. If you do not include an unsubscribe link in your template, your message must have the Transactional option selected.

After you select a template, you can click and then select Custom HTML to add or remove unsubscribe links to support your message.

  1. Open your messaging project, click Create, and select Message.
  2. (Optional) Add a message name and/or flag the message as a test.
    1. Click in the header.
    2. Enter the name.
    3. Enable the Test toggle.
    4. Click outside the box to close it.
  3. Under Channels, select Email and deselect all other channels.
  4. Select Upload Users and then click Content in the header to move on. You will upload your user list just before sending the message.
  5. Select Email Template.
  6. Select the template you want to use and click Continue with Selected Template.

     Tip

    You can customize a template-based message by clicking and selecting the corresponding non-template content type after you select your template. For example, after you select your email template, click and then select Custom HTML to edit your template-based message.

    Customizing a template-based message does not save changes to the template itself.

  7. Update Settings for the message, and then click Delivery in the header to move on.
    • From Name and From Email: The name and email address your message is from.
    • Reply To Email: The address your audience can send replies to.
    • Transactional An email sent in response to a user's interaction with your app or website — receipts, shipping notifications, password reset notifications, etc. : Set if your message is a direct response to user interactions with you — receipt for a purchase, shipping updates, etc. Otherwise, your email (or email template) is Commercial A promotional email sent to an audience of users who have opted to receive promotional marketing messages from you. and requires an unsubscribe link.
    • Bypass Status: Send the message to audience members even if they have opted out of transactional messages. Use this setting for business critical emails only.
  8. Select a delivery type and Optional Features, then click Review in the header.
  9. Review your message. If you are ready to send it, click Upload & Send.
  10. Click Choose File, and select the CSV file containing your list of users and merge fields.
  11. Click Send Message.

Unsubscribe Links for Email

When sending a commercial email, your message must include a link to unsubscribe from your mailing list.

  • In the HTML Body of your email, include a link with a data-ua-unsubscribe="1" attribute in the format:

    <a data-ua-unsubscribe="1" title="unsubscribe" href="https://www.unsubscribe.com">Link Title</a>

  • In the Plain Text Body of your email, include a link in the format: [[ua-unsubscribe href="your url here"]]

If your unsubscribe link includes an href, Airship unsubscribes the user before redirecting to your page.

Airship reflects unsubscribe events in the Real-Time Data Stream. When users unsubscribe, Airship also assigns them commercial_opted_out or transactional_opted_out values based on the type of email they unsubscribed from.

Upload Users

If sending an email, SMS, or open channel message, you can Upload Users in the Audience step of the Message composer. This provides a means to register new users and send them a message at the same time.

 Important

Upload Users can only be used with a single channel at a time. Make sure you have only Email, SMS, or a single Open Channel enabled.

Complete the rest of the composer like normal, and you will upload the list during the Review step. The Send Message button will instead be labeled Upload & Send. After clicking the button:

  1. Click Choose File, and select the file that contains your list of users.
  2. Click Send Message.

See Audience Lists: Inline Lists for file format requirements and general information about Inline lists.