Back to Help Home
Campaigns & Broadcasting

Personalizing messages with template variables

3 minutes read time Difficulty: beginner

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 patternAuto-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:

  1. In the campaign builder, look for the "Template Parameters" section
  2. Enter a default value for each variable
  3. 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

  1. Always use the name{{1}} should be the recipient's name
  2. Keep defaults natural — "your order" is better than "N/A" or blank
  3. Test first — Send to yourself to verify variables fill correctly
  4. Don't over-personalize — 2-3 variables is usually enough
  5. 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.

Was this guide helpful?

Your feedback helps us make these guides better for everyone.