Placeholders (also called merge tags or variables) allow you to personalize each email automatically. The system replaces placeholders with actual user data when sending emails.
Universal Placeholders (All Automation Types):
Placeholder | Description | Example Output |
---|---|---|
{{USERNAME}} | User’s login username | john_doe |
{{FIRSTNAME}} | User’s first name | John |
{{LASTNAME}} | User’s last name | Doe |
{{EMAIL}} | User’s email address | john@example.com |
{{BALANCE}} | User’s current balance | 1,234.50 |
Note on {{BALANCE}}:
- Automatically detects user’s credit type (SMS Credits or Wallet)
- Shows SMS Balance for credit-based users
- Shows Wallet Balance for wallet-based users
- No need to use separate placeholders
Inactive User Automation Placeholders:
Placeholder | Description | Example Output |
---|---|---|
{{LASTMESSAGEDATE}} | Date of user’s last message | 2024-08-15 |
{{INACTIVEDAYS}} | Days since last message | 45 |
New User Automation Placeholders:
Placeholder | Description | Example Output |
---|---|---|
{{REGISTRATIONDATE}} | User’s signup date | 2024-10-01 |
{{DAYSSINCEREGISTRATION}} | Days since signup | 10 |
How to Use Placeholders:
In Email Subjects:
We Miss You, {{FIRSTNAME}}! 👋
Your {{BALANCE}} Credits Are Waiting, {{USERNAME}}
In Email Content:
<p>Hi <strong>{{FIRSTNAME}}</strong>,</p>
<p>We noticed you haven't sent any messages in the last
<strong>{{INACTIVEDAYS}} days</strong>. Your last message was on
<strong>{{LASTMESSAGEDATE}}</strong>.</p>
<p>You still have <strong>{{BALANCE}}</strong> credits available!</p>
Placeholder Best Practices:
- Always Use Fallbacks: Ensure your message still makes sense if a placeholder is empty
- Test Thoroughly: Send test emails to verify placeholder replacements
- Be Personal But Professional: Use first names for friendly tone
- Highlight Value: Use balance placeholders to remind users of unused credits
- Create Urgency: Use inactive days to create time-based urgency
HTML Formatting:
Placeholders work with HTML formatting:
<p>Dear <span style="color: #007bff;">{{FIRSTNAME}}</span>,</p>
<p>Your balance: <strong class="highlight">{{BALANCE}}</strong> credits</p>