Docs
Mail Merge fields can be used to personalise the content in Chargebee while configuring:
Mail Merge fields are dependent on the template selected for a particular email. You can find the list of fields in the Chargebee application as shown below:
When currency mergevars are used in conditional statements, the amount should be specified in cents and as an integer (i.e. 0 instead of $0.00, 999 instead of $9.99).
You can add mail merge fields as a part of your configuration to populate the values dynamically.
Articles & FAQ Your current plan is {{plan.name}}.
RESULT:
Your current plan is Basic.
If the field contains a value, then the content inside the block will be displayed. '#' indicates that the condition to be checked has to be true. '/' indicates the end of the field block.
Dear Customer,
{{#plan.setup_cost}}
Your setup cost is {{plan.setup_cost}}.
{{/plan.setup_cost}}
Thank you for your purchase.
RESULT:
Dear Customer,
Your setup cost is $12.50.
Thank you for your purchase.
If the mail merge field does NOT contain a value, the content will be ignored.
Dear Customer,
{{#plan.setup_cost}}
Your setup cost is {{plan.setup_cost}}.
{{/plan.setup_cost}}
Thank you for your purchase.
RESULT:
Dear Customer,
Thank you for your purchase.
If the field contains a value, then the content entered within the block is displayed, like plan name, addon name, etc. Else it will be ignored.
{{#plan.name = basic}}
Since you are in basic plan you have only email support.
{{/plan.name = basic}}
RESULT:
Since you are in basic plan you have only email support.
If the field is empty or does not have a specific value, the content entered within the block is displayed. " ^ " indicates that the condition specified has to be false.
SAMPLE #1
{{^customer.company}}
You have not provided the company name
{{/customer.company}}
Thank you for your purchase.
RESULT:
You have not provided the company name
Thank you for your purchase.
SAMPLE #2
To display content when field does not have the specified value:
{{^plan.name = enterprise}}
Upgrade to the enterprise plan and enjoy 24/7 phone support.
{{/plan.name = enterprise}}
RESULT:
Upgrade to the enterprise plan and enjoy 24/7 phone support.
Enumerated string refers to values, like subscription statuses (active, canceled, trial…), invoice statuses (paid, not paid…), etc.
SAMPLE #1
{{#card.status = expiring}}
Your card is about to expire.
{{/card.status = expiring}}
RESULT:
Your card is about to expire.
SAMPLE #2
Using an enumerated string with a false condition:
{{^invoice.status = paid}}
You have an outstanding invoice.
{{/invoice.status = paid}}
RESULT:
You have an outstanding invoice.
Used to display a list of items (objects that may have multiple entries in the subscription) such as addons, coupons etc.
{{#addons}}
Addon Name : {{addon.name}}
Addon Price : {{addon.price}}
{{/addons}}
RESULT:
Addon Name : Support Plan
Addon Price : $9.99
Addon Name : License
Addon Price : $19.99
You can use 'format' and 'timezone' attributes along with the timestamp fields, such as {{subscription.trial_end}} to change the default format of the date and time or convert it to a specific timezone. Click here for more details.
SAMPLE #1
You signed up for your subscription on
{{subscription.created_at | format : dd-MMM-yyyy hh:mm:ss z}}
RESULT:
You signed up for your subscription on
14-May-2016 11:07:00 UTC
SAMPLE #2
Your subscription was activated on
{{subscription.activated_at | timezone: EST}}
RESULT:
Your subscription was activated on
14-May-2016 06:07:00
SAMPLE #3
Your trial ends on
{{subscription.trial_end | format : dd-MMM-yyyy hh:mm:ss z | timezone: EST}}
RESULT:
Your trial ends on
14-May-2016 06:07:00 EST