Personalizing messages with template variables
Personalizing messages with template variables
Make every campaign message feel personal by using dynamic variables that fill in each recipient's data.
How variables work
Template variables are placeholders like {{1}}, {{2}}, {{3}} that get replaced with actual values for each recipient.
Template:
Hi {{1}}! Your order {{2}} is ready for pickup at {{3}}. Show this message at the counter.
Sent to John:
Hi John! Your order #ORD-789 is ready for pickup at Store A. Show this message at the counter.
Sent to Jane:
Hi Jane! Your order #ORD-456 is ready for pickup at Store B. Show this message at the counter.
Providing variable values
In manual entry
Add values after the phone number and name, separated by commas:
+919876543210, John, ORD-789, Store A
+919876543211, Jane, ORD-456, Store B
Format: phone, name ({{1}}), {{2}}, {{3}}, ...
In CSV import
Add columns for each variable:
phone_number,name,order_id,store
+919876543210,John,ORD-789,Store A
+919876543211,Jane,ORD-456,Store B
The columns after name map to {{2}}, {{3}}, etc. in order.
From contacts/segments
When importing from contacts or segments, AIsoule auto-maps:
{{1}}→ Contact name- Other variables need default values (set in the campaign settings)
Auto-mapped variables
AIsoule automatically fills these common variables:
| Variable pattern | Auto-fills with |
|---|---|
{{1}} or {{name}} | Recipient's name |
{{phone}} | Recipient's phone number |
{{email}} | Recipient's email |
Default values
For variables that can't be auto-mapped, set default values:
- In the campaign builder, look for the "Template Parameters" section
- Enter a default value for each variable
- This value is used when a recipient doesn't have specific data
Example: If {{2}} is "order_id" and some recipients don't have one, the default might be "your recent order".
Tips for personalization
- Always use the name —
{{1}}should be the recipient's name - Keep defaults natural — "your order" is better than "N/A" or blank
- Test first — Send to yourself to verify variables fill correctly
- Don't over-personalize — 2-3 variables is usually enough
- Validate data — Missing variables cause message failures
Troubleshooting
"Missing template parameters" — Some recipients don't have values for all variables. Either provide defaults or ensure your CSV has all columns filled.
"Variable count mismatch" — Your CSV has fewer columns than the template expects. Add the missing columns.
"Blank variable in message" — The recipient's data was empty for that field. Set a default value to prevent this.
Related Articles
Was this guide helpful?
Your feedback helps us make these guides better for everyone.