All Products
Search
Document Center

Direct Mail:Create an email template

Last Updated:Jun 02, 2026

Email templates define the subject, body, and personalization variables for your outgoing emails. Create a template, submit it for review, and test it before sending to recipients.

Template status

The template management page in the Direct Mail console lists each template's name, status, creation time, and available actions.

A template has one of three statuses: draft, Approved, or Rejected. Templates in draft status must be submitted for review before use. The Direct Mail operations team reviews each submission and typically completes the review within 1 to 3 business days.

image.png

Create an email template

  1. Log on to the Direct Mail console.

  2. In the left navigation pane, click Template management.

  3. In the upper-right corner of the template management page, click Create Template.

  4. Fill in the required parameters, including the email subject, body content, and any variables or images. Click Save.

The template is saved as a draft. You can edit, submit for review, or delete it at any time.

image

Variables

Variables let you personalize each email with recipient-specific data. Use {VariableName} as a placeholder in the email body — the system replaces it with the corresponding value for each recipient at send time.

For example:

Hello, {UserName} {Gender}, your email address is {EmailAddr}, and your birthday is {Birthday}. Welcome to Direct Mail.

The system replaces {UserName}, {Gender}, {EmailAddr}, and {Birthday} with the values from each recipient's record.

Rules:

  1. Format: Enclose the variable name in braces — for example, {UserName} and {Birthday}.

  2. Naming: Use only uppercase and lowercase English letters — for example, UserName and Birthday.

  3. Data sources:

    1. For testing, enter a value directly on the Send test email tab (for example, enter John for {UserName}).

    2. For production use, provide the corresponding column values when you create a recipient list. Upload an attachment or create entries in JSON format — for example, {"UserName":"John Doe","Birthday":"1990/01/01","Gender":"Ms."}. Without matching column names, the system cannot replace variables correctly.

  4. Limit: Up to 50 variables per template.

Images

You cannot insert local images directly into email templates. Use image URLs that start with HTTPS and allow hotlinking. Host your images on an external service such as an online photo album, then paste the URL into the template.

image

image

Unsubscribe link

To add an unsubscribe link, click the Hyperlink button and select Unsubscribe link.

image

Unsubscribe management

Manage unsubscribe records in the Direct Mail console under Statistics > Unsubscribe.

  1. Click Submit for review. The review process takes 1 to 3 business days. If the template is rejected, edit it and resubmit.

    Note
    • Each account supports up to 100 email templates.

    • The email body size limit is 1 MB.

    • The email subject length limit is 100 characters.

    • Editing an approved template or a template that has been used to send emails resets its status to draft. You must resubmit it for review.

Send a test email

Test the template before submitting it for review.

  1. Open the saved template and go to the Send test email tab.

  2. Select a sender address, enter values for each variable (for example, enter John Doe for {UserName}), and enter a recipient address.

  3. Click Send.

image

image

The recipient receives the email with each variable replaced by the value you entered.

image

Note

The system sends test emails from a random address. For production emails, using a random sender address is optional.