Email Templates

You can modify the content of emails sent by AppManager. In this way, you can provide your own branding to the emails or translate them to another language. This article explains the process of editing email templates and how to display context-specific information in your templates.

Editing Templates

To edit an email template in AppManager:

  1. Under App Distribution, select Settings -> Email templates.
  2. Select an email template from the list.
  3. Modify the template fields:

    • Subject: the subject of the email that users will receive.
    • From email: the email address that will appear as a sender of the email. You can provide an email address of your choice or keep using the default AppManager email by typing in {{DefaultFromEmail}}.
    • From name: the name that will appear as a sender of the email. You can provide a name of your own or use the {{DefaultFromName}} placeholder. The default value is Telerik AppManager.
    • Reply to: the email address that will be set as recipient if the user replies to your email. This field can be left empty or you can provide an email address of your choice. It can also use the {{DefaultFromEmail}} value.
    • Message: the email content. You can edit it with the visual tools of the editor, or switch to HTML mode and type in your HTML directly.

      There are different data fields that you can use in the message body, depending on the template type. They are listed in the following sections.

  4. Click Save.

AppManager updates the saved template in your account backend and the new template will be used every time an email of the given type is sent to a user.

Be careful when replacing the message content. Any links that you delete from the message will not be available to your users. This may result in an unusable message, e.g. reset password email without a reset link.

Reverting Changes

If you have modified an email template and you are not happy with the result, you can reset the template to the initial state provided by AppManager. To do this, in App Distribution Portal:

  1. Click Settings -> Email templates in the side navigation under App Distribution.
  2. Select an email template from the list.
  3. Click Reset in the template preview.

When resetting a template, AppManager uses the default template for the current type of email. You will lose any changes you applied to the template in the past.

Testing Templates

When you are finished with your changes to the email templates, you can send a test email to an address (or multiple addresses) of your choice and see the resulting content. In this way, you can avoid sending emails with broken links or layout to your users.

To send a test email:

  1. Click Settings -> Email templates in the side navigation under App Distribution.
  2. Select an email template from the list.
  3. Click Send test.
  4. Type in one or more email addresses in the form.
  5. Click Send.

AppManager sends an email to all listed addresses. Any placeholders of bindable fields, in your email content, are replaced with sample data.

If the test email that you receive contains any placeholders or remains of Mustache expressions that you used in your template, this means that the syntax isn't correct or the fields that you try to use do not exist. This content will also be visible in emails to users if you do not modify the template to address these issues.

Email Template Types

This section lists the email template types that you can edit in AppManager, as well as the fields that you can use in these templates to bind to a value from the templates context. The templates support Mustache-like placeholders for data values, conditional blocks and loops, so you can display contextual data in your emails. You can use the existing templates content as an example of the supported syntax.

Invitation

This is the template for the email that AppManager sends when you invite a new user. It contains a registration link that you must not delete from the template. If you decide to replace the link button, make sure you create a new link or button with a target set to {{UserSignupUrl}}.

Welcome

This is the template for the email that AppManager sends when a user completes their registration. It provides the initial information a user needs when starting to use AppManager including links to the available mobile apps and the web catalog. The following bindable fields are available in this template:

  • DisplayName: the current user display name. When the email is sent to a user, the {{DisplayName}} placeholder is replaced with the name of the user.
  • AccountTitle: the name of your AppManager account. By default, this is the name of your account. You can change it by going to Settings -> General and modifying the AppManager private app store name value.
  • HubIosApplicationDownloadUrl: the link to the iOS version of the AppManager mobile app. It is available only if you have re-signed the iOS app in Settings -> iOS Mobile App.
  • HubWpApplicationDownloadUrl: the link to the Windows Phone version of the AppManager mobile app. It is available only if you have re-signed the Windows Phone app in Settings -> Windows Phone Mobile App.

Register iOS Device

This is the template for the email that AppManager sends when you opt to send an additional email to collect UDIDs, while inviting users. This email displays a button that the user needs to tap from each of his iOS devices. Therefore, you must not delete the device registration URL from the template. The following bindable fields are available in this template:

  • DisplayName: the current user display name. When the email is sent to a user, the {{DisplayName}} placeholder is replaced with the name of the user.
  • AccountTitle: the name of your AppManager account. By default, this is the name of your account. You can change it by going to Settings -> General and modifying the AppManager private app store name value.
  • AppManagerDeviceRegistrationUrl: the link that the user needs to open in order to register their iOS device.

Reset Password Request

This is the template for the email sent by AppManager when a user requests a password change. The email provides a link to the page where the user can reset their password. Note that the URL to this page is unique and when you modify this template, you must provide the same link as the one from the unmodified template. The bindable fields available in this template are:

  • AppManagerPasswordResetUrl: the URL to the password reset page.
  • User.PasswordResetCode: a unique parameter that needs to be passed when opening the above URL. Your password reset link must look like this: {{AppManagerPasswordResetUrl}}/{{User.PasswordResetCode}}.

Password Changed

This is the template for the email sent by AppManager when a user successfully changes their password. The bindable fields available in this template are:

  • User.DisplayName: the current user display name. You can use it to address the user by name.

Single App Distribution

This is the template for the email sent by AppManager when you publish a new app and opt in to send notifications to users. It is also sent when you select an app in the Apps list in App Distribution Portal and click Resend Email. The following bindable fields are available in this template:

  • AccountTitle: the name of your AppManager account. By default, this is the name of your account. You can change it by going to Settings -> General and modifying the AppManager private app store name value.
  • AppImageUrl: the app icon URL. The app image will always appear broken in the template, as this URL is generated dynamically when AppManager actually sends the email.
  • AppVersion: the version of the app.
  • AppDescription: the description of the app (if available).
  • AppChangelog: the changelog for the current version. Available only if the app is a new version of an existing app and you have provided information in the New in this version field when uploading this version.
  • AppPlatformType: the name of the OS the app is targeted at—Android, iOS or Windows Phone.
  • AppPlatformVersion: the version of the OS the app is targeted at.
  • AppSize: the app size.
  • AppDownloadURL: the URL where the app can be directly downloaded on a device.
  • IosHubAppUrl: the link to the iOS version of the AppManager mobile app. It is available only if you have re-signed the iOS app in Settings -> iOS Mobile App.
  • WpHubAppURL: the link to the Windows Phone version of the AppManager mobile app. It is available only if you have re-signed the Windows Phone app in Settings -> Windows Phone Mobile App.

Multiple Apps Distribution

This is the template for the email sent by AppManager when a new user is invited and registers in your AppManager account and when you select the user from the Users list in App Distribution Portal and click Resend -> Resend email notification. The following bindable fields are available in this template:

  • AccountTitle: the name of your AppManager account. By default, this is the name of your account. You can change it by going to Settings -> General and modifying the AppManager private app store name value.
  • Applications: a list of all apps available for the current user to download (based on the groups the user belongs to and the type of device they registered in AppManager.
    • Name: the app name.
    • IconUrl: the app icon URL. The app image will always appear broken in the template, as this URL is generated dynamically when AppManager actually sends the email.
    • Version: the version of the app.
    • Platform: the minimum supported OS version.
    • DownloadUrl: the URL where the app can be directly downloaded on a device.

Deployment App Distribution

This is the template for the email sent by AppManager when a new user is invited and registers in your AppManager account and when you re-sign one of the AppManager mobile apps in Settings -> AppManager Mobile App. It is also used when you explicitly select a user in the Users grid and click Resend -> Resend AppManager app. The following bindable fields are available in this template:

  • AccountTitle: the name of your AppManager account. By default, this is the name of your account. You can change it by going to Settings -> and modifying the AppManager private app store name value.
  • Applications: a list of the available mobile applications, excluding the Android one. The list depends on which mobile apps you have re-signed in Settings -> AppManager Mobile App.
    • Name: the name of the app.
    • IconUrl: the mobile app icon URL. The app image will always appear broken in the template, as this URL is generated dynamically when AppManager actually sends the email.
    • Version: the app version.
    • MinPlatformName: the minimum supported OS version.
    • DownloadUrl: the URL where the app can be downloaded on a device.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.