Audience segmentations
Configure alternate versions of Payment Confirmation and New Subscription email templates that target specific customer subsets by billing or account country code.
Definition
Key benefits
Key details
Supported templates
Audience segmentation works with exactly two email templates: New Subscription and Payment Confirmation. Each has a default version that all customers receive unless they match an alternate template's audience criteria.
How audience criteria work
Audience criteria determine which customers receive an alternate template instead of the default. A few rules govern how they behave:
- You must define at least one criterion in the Audience section for an alternate template to activate.
- Criteria use OR logic — a customer who matches any one criterion qualifies for the alternate template.
- Customers who don't match any criterion continue to receive the default template.
Locale support
Alternate templates support all Recurly locales. After defining your audience segment, you can customize the email content for each locale independently.
For example, if your segment targets customers in the UK, Italy, and Sweden:
- Customize the content for the UK audience in English.
- Use locale support to add Italian and Swedish translations.
- Recurly routes the alternate template to customers in those countries, in the language set for their region.
PDF attachments
You can attach a PDF to an alternate template. Each locale on an alternate template supports its own unique PDF attachment, keeping your message consistent across languages.
Managing your alternate templates
After creation, your alternate template appears in the Email Templates section. From there you can preview the HTML, edit content, rename, or delete the template.

Renaming a template
Hover over the ellipsis next to the alternate template and select Rename. Save your changes when done.

Create an alternate template
Add audience criteria
Upload a PDF attachment
Updated 2 months ago