Email Templates | Creating an email template

Email templates can be used whenever you need to send an email for a recurring situation, for example:

  • A standardized response to approve a vacation request.

  • An alert to a manager whenever a team member adds a new objective.

  • To prompt for and track a competency assessment.

The template contains the standard text you want to include in all emails based on it, along with merge fields and attached files. When an email based on an email template is sent, the merge fields are replaced with the content they represent.

Email templates are used:

  • By Action Events. Action Events are sent automatically by Sage People in response to specific events such as every time an HR request is created by a manager, or when a performance review is approved by HR or a senior manager.

  • When sending bulk email.

To create a new email template:

  1. Go to Setup, and in Quick Find enter email, and select Classic Email Templates.

  2. Select New Template.

    Sage People displays Step 1 of the New Template wizard:

    Screenshot: Step 1 of the Email Template wizard

  3. Select the type of email template you want to create:

    • Text

      The simplest form of email template.

    • HTML (using Classic: Letterhead)

      An HTML template based on a predefined letterhead. You must have an active letterhead to create this type of email template.

    • Custom (without using Classic: Letterhead)

      An HTML template created from HTML code without using a predefined letterhead.

    • Visualforce

      Suitable for more complex email templates requiring advanced merging with a recipient's data and information from multiple records. You need to be familiar with Visualforce, the user interface framework for the Salesforce platform.

    The pages displayed after this point depend on the selection you make. This procedure covers creating a template in HTML (using Classic: Letterhead).

  4. Select Next.

    Sage People displays Step 2 of the New Template wizard:

    Screenshot: Step 2 of the Email Template wizard

  5. Complete the fields as follows:

    Field Description

    Folder

    Picklist. Select the picklist and choose the folder you want to store the template. The folder must be accessible to all users you intend to use the template.

    Available For Use

    Checkbox. If checked, the email template can be selected for use as the basis for an email.

    Email Template Name

    Text. A meaningful short name for the template. If you have several templates, use a name making the template easy to identify. Use Description to expand on the Template Name and clarify its purpose.

    Template Unique Name

    Text. Automatically created by Sage People when you enter the Email Template Name. The Template Unique Name is used to refer to the template through the API and prevents naming conflicts on package installation.

    You should not need to change this value, but if you do, ensure the name:

    • Is unique within your Salesforce organization.

    • Begins with a letter.

    • Contains only alphanumeric characters and underscores, and does not include spaces or two consecutive underscores.

    • Does not end with an underscore.

    Classic Letterhead

    Picklist. The pre-defined letterheads you have available. Select the picklist and choose the letterhead you want to use with this template.

    Email Layout

    Picklist. The overall design you want to use to lay out the content of the email template. Select the picklist and choose the layout you want. To view simplified previews, select View Email Layout Options beside the input field.

    Encoding

    Picklist. The character set to be used by the template. Do not change this unless you have a good reason for doing so.

    Description

    Text. The purpose of the template. Enter a description other users will find helpful to correctly identify the template.

    Subject

    Text. The subject line you want to use for emails based on this template. Enter text summarizing the email and helping ensure it is noticed and read by recipients.

    You can also enter merge fields in Subject.

  6. Select Next.

    Sage People displays Step 3 of the New Template wizard using the options you selected in Step 2 of the Wizard:

    Screenshot: Step 3 of the Email Template wizard

  7. Build the content of the email template:

    • Select a section on the layout and use the formatting controls above to configure your content:

      Screenshot: Formatting controls toolbar

    • To insert merge fields into your template use the Merge Field selector:

      Screenshot: Available Merge fields in the Email Template wizard

      Select the object hosting the field you want to merge:

      Screenshot: Selecting the Object to choose a Merge field

      Select the field:

      Screenshot: Selecting the field to use as a Merge field

      Copy the merge field value:

      Screenshot: Copy Merge Field Value field

      Paste the merge field value into the template:

      Screenshot: Pasting the Merge field value into the Email Template

    • To add a $ (dollar sign) to your template, typically as a prefix for a currency amount, enter \$ (backslash dollar). Entering a dollar sign without the preceding backslash causes the email template to fail.

  8. Select:

    • Preview

      To display a preview of the template in a new browser window. The preview includes any merge field names as you inserted them and not substituted values. Use the preview to check the overall layout of the template. If you make changes to the template you must close the existing preview window and select Preview again to include your changes in a new preview.

    • Previous

      To redisplay Step 2 of the New Template Wizard.

    • Next

      To display Step 4 of the New Template Wizard.

    Sage People displays your chosen option.

  9. Step 4 of the New Template Wizard enables you to create a customized text only version of the email template for display by recipients who cannot view the HTML version.

    • If you leave the text only version blank, Sage People automatically creates a text only version derived from the HTML version. Any changes you make to the HTML version are included in the automatically created text only version.

    • If you create your own text only version it will not be modified to include any changes you make to the HTML version.

    Screenshot: Step 4 of the Email Template wizard

    • To base your text only version on the HTML version, select Copy text from HTML version.

      Sage People asks you to confirm:

      Screenshot: Warning when attempting to create a new text only version of an Email Template

      Select OK.

      All text content from the HTML version is copied, including any merge fields.

      You can also add merge fields to your text only template using the Select Field Type, Select Field, and Copy Merge Field Value fields at the top of the page in the same way as the HTML version.

  10. Select Save.

    Sage People displays the Email Template Detail page for the template you have created.

  11. Check the template is as you want it. To test the template and validate the merge fields, select Send Test and Verify Merge Fields.

  12. When the template is complete, return to the Classic Email Templates home page and select Edit for the template, or select Edit Properties from the Email Template Detail page.

    Sage People displays the Email Template Edit page.

  13. Select the Available For Use checkbox.

  14. Select Save.

    Your email template is now ready for use.