Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Email Mapping

Emails v2 are versatile, handy and rich with features, has a sleeker UI and comes with additional mergevars you could use in emails templates.

Chargebee seamlessly handles your move from Email v1 to v2 with utmost care so as to make sure you don't lose email template data (unless you intentionally decline to move data). The migration also gets you up and running with the moved templates and data in Email v2.

You are provided with two options while moving to Email v2,

  • Move with email data
  • Move without email data

This doc serves as a central source of reference if you chose to move from Email v1 to v2 in either of the cases of with or without data. It is recommended you go through the doc completely to understand email template mapping between v1 and v2 and feature compatibility before sending emails through v2.

Information

Regardless of the approach chosen to move to v2, Email v1 data would be backed up and found under Settings > Import and Export for up to 14 days.

Data moved from Emails v1 to v2

  • Template
    • Email content
    • Email subject
    • From addresses
    • Checkboxes if enabled, will also be enabled in v2
  • Header and Footer
  • Segment filters in use

Note

  • Feature enabled emails if available, are also moved. For example, Offline Dunning Reminder emails are only available if you have enabled Offline Dunning.
  • Emails which are disabled and not in use are also moved to v2.
  • Emails which are enabled and in use in v1, are also enabled in v2 by default after moving.

Email mapping between v1 and v2

This table contains the mapping between Emails v1 to v2 and template specific additional information.

Availabilityv1v2Additional information
DefaultCustomer CreatedSubscription Management > Onboarding Emails > Customer created-
Subscription CreatedSubscription Management > Onboarding Emails > All 4 welcome emails for subscription created-
Subscription StartedSubscription Management > Subscription Activation > from 'Future' state-
Subscription ActivatedSubscription Management > Subscription Activation > from 'Trial' state-
Subscription ChangedSubscription Management > Subscription Changes > Subscription is changed-
Subscription CanceledCustomer Retention > Subscription Cancellations > On cancellation-
Subscription Shipping Address UpdatedSubscription Management > Subscription Changes > Shipping address is updated-
Invoice ReceiptInvoices, Credit Notes & Payments > Invoice Receipt > Invoice is generatedCheckbox if enabled, is also copied.
Subscription Trial Ending First ReminderSubscription Management > Trial Management > 5 days before expiry
  • Email v2 is populated with the "X" days reminder interval specified in v1.
  • Checkbox if enabled, is also copied.
Subscription Trial Ending Second ReminderSubscription Management > Trial Management > 5 days before expiry
  • Email v2 is populated with the "X" days reminder interval specified in v1.
  • Checkbox if enabled, is also copied.
  • A new email template is created.
Subscription Renewal First ReminderSubscription Management > Subscription Renewal Reminders > 5 days before renewal
  • Email v2 is populated with the "X" days reminder interval specified in v1.
  • Checkbox if enabled, is also copied.
  • If a segment filter is selected in email v1, only that segment is copied to email v2 and can be found under "Send to" dropdown list. Learn more.
Subscription Renewal Second ReminderSubscription Management > Subscription Renewal Reminders > 5 days before renewal
  • Email v2 is populated with the "X" days reminder interval specified in v1.
  • Checkbox if enabled, is also copied.
  • If a segment filter is selected in email v1, only that segment is copied to email v2 and can be found under "Send to" dropdown list. Learn more.
  • A new email template is created.
Subscription Canceling ReminderCustomer Retention > Subscription Cancellations > 5 days before CancellationEmail v2 is populated with the "X" days reminder interval specified in v1.
Payment SucceededInvoices, Credit Notes & Payments > Payment & Credits > Initial/Recurring charge is successfulCheckbox if enabled, is also copied.
Payment Failed
  • Revenue recovery > Payment Failures -> Payment Failure
  • Revenue recovery > Dunning for online payments > All emails
Checkboxes if enabled, are also copied.
Payment RefundedInvoices, Credit Notes & Payments > Payment & Credits Refund is SuccessfulCheckboxes if enabled, are also copied.
Card Expiry ReminderCustomer Retention > Invalid Payment Method > 5 day(s) before expiry-
Card ExpiredCustomer Retention > Invalid Payment Method > On card expiration-
Only if Pause Subscription is enabledSubscription PausedSubscription Management > Subscription Pause & Resumption > On pause-
Subscription ResumedSubscription Management > Subscription Pause & Resumption > On resumption-
Subscription Pause ReminderSubscription Management > Subscription Pause & Resumption > 5 days before pause-
Subscription Resumption ReminderSubscription Management > Subscription Pause & Resumption > 5 days before resumption-
Only if Direct Debit is enabledPayment InitiatedInvoices, Credit Notes & Payments > Payment & Credits > Charge is initiated-
Refund InitiatedInvoices, Credit Notes & Payments > Payment & Credits > Refund is initiated-
Only if Offline Dunning is enabledOffline Dunning ReminderRevenue Recovery > Dunning for offline payments > All emails-
Only if Payment Terms is enabledNet D - Payment Due Reminder Invoice, Credit notes & Payments > Payment Terms (Net-D) > Notifications > 5 days before invoice due date-
Customer Portal Emails
DefaultAccount LockedPortal Account Management > Locked accounts-
Password ChangedPortal Account Management > Locked accounts-
Only if Single Page Customer Portal is usedSignup EmailSystem-generated email-
Forgot Password-
Email Verification -
Email Changed-

Segmentation is a paid feature in Emails v2 and if you were using it in Email v1, only the segment filters you used are moved seamlessly to the corresponding email in v2, and by default has that filter selected in the Send to list.

For example, if you had used Subscription Renewal First Reminder email in v1 with the segment filter bi-monthly or longer, while you move to Email v2, the same filter is mapped to the corresponding email in v2. The email in v2 now has segment filter bi-monthly or longer selected by default in the Send to list.

Reminder emails is also a paid feature in Emails v2. However, if you were using it in Email v1, it is seamlessly moved to Email v2 and you can edit and make changes to the template if necessary. However, if you try and create new one, it won't be allowed.

Was this article helpful?