--- updatedAt: 2026-06-09T19:31:54.000Z agentTools: siteIndex: https://docs.recurly.com/llms.txt projectIndex: https://docs.recurly.com/recurly-subscriptions/llms.txt --- # Email language support (30) Learn how to configure Recurly's email language support to send customer communications in 30 locales, set default languages, and customize email templates by region.
Recurly supports email communications in 30 locales, letting you reach subscribers in the language they know best. Configure a site-wide default language, set individual customer language preferences, and customize email templates by region — including PDF invoice attachments that automatically match the email language.
Not included in Starter or Pro — contact Recurly Sales to upgrade
1Definition 2Key benefits 3Key details 4Configure email language support
# Definition
Email language support lets merchants send customer communications in each subscriber's preferred language and locale. A locale covers more than language — it also determines regional formatting conventions for dates, times, currency symbols, and numbers. In sandbox mode, you can enable and test as many languages as needed. In production, the number of available languages depends on your Recurly subscription plan.
# Key benefits
Global reach, regional relevance Communicate with subscribers worldwide in the language and regional conventions that feel native to them — not just a translated version of your default template.
Better customer experience Clearer communication reduces friction and misunderstandings, giving subscribers a more confident and comfortable interaction with your brand.
Higher engagement rates Emails delivered in a subscriber's native language are more likely to be opened, read, and acted on.
Flexible configuration Set language preferences at the site level or per individual customer, and adjust them at any time through the API, Hosted Payment Pages, or the Admin Console.
Consistent invoice language PDF invoice attachments automatically match the language of the email, keeping the entire communication consistent end to end.
# Key details ## Supported languages and locales Recurly supports 30 locales. Each locale defines both the language and regional formatting conventions — for example, `en-US` uses `mm/dd/yyyy` for dates while `en-GB` uses `dd/mm/yyyy`.
LanguageAPI value
Chinese (China)zh-CN
Danish (Denmark)da-DK
Dutch (Belgium)nl-BE
Dutch (Netherlands)nl-NL
English (Australia)en-AU
English (Canada)en-CA
English (Ireland)en-IE
English (New Zealand)en-NZ
English (United Kingdom)en-GB
English (United States)en-US
Finnish (Finland)fi-FI
French (Canada)fr-CA
French (France)fr-FR
German (Germany)de-DE
German (Switzerland)de-CH
Hindi (India)hi-IN
Italian (Italy)it-IT
Japanese (Japan)ja-JP
Korean (Korea)ko-KR
Polish (Poland)pl-PL
Portuguese (Brazil)pt-BR
Portuguese (Portugal)pt-PT
Romanian (Romania)ro-RO
Russian (Russia)ru-RU
Slovakian (Slovakia)sk-SK
Spanish (Mexico)es-MX
Spanish (Spain)es-ES
Spanish (United States)es-US
Swedish (Sweden)sv-SE
Turkish (Turkey)tr-TR
## Default language Recurly uses English (United States) as the site default. Merchants on multi-language plans can change the default to any enabled language. The default language is applied to any customer who doesn't have an individual language preference set. ## Customer language preference Individual customer language preferences can be set through the API, Hosted Payment Pages, the Admin Console, or Hosted Account Management Pages. Always ensure the language assigned to a customer is one that's enabled on your site — setting a disabled language will result in a validation error. ## Email translations and parameters Recurly provides default email templates in every supported language and allows merchants to customize them further. Some content — such as plan names or your company name — won't be automatically translated and must be updated manually for each language variant. Recurly also adjusts certain email parameters to match regional conventions; for example, currency symbols may appear before or after the amount depending on the locale. ## PDF invoice attachments When an email includes an attached PDF invoice, the invoice is generated in the same language as the email. This keeps the entire communication — from subject line to invoice line items — consistent for the subscriber. # Configure email language support
1

Open Configure Languages

In the Admin Console, go to Configuration → Email Templates → Configure Languages.

2

Enable a language

On the Configure Languages page, select the language you want to enable. Once enabled, it becomes available to assign to individual customers.

3

Set the default language

On the same page, set a site-wide default language. This language is used for any customer without an individual preference set.

4

Disable a language (if needed)

To disable a language, find it on the Configure Languages page and disable it. Customers previously set to that language will automatically revert to the site default.

5

Customize email templates by language

Go to Email Templates and select a language from the language selector to edit that language's version of a template. Preview and send test emails before enabling the template in production.

6

Set individual customer language preferences

Assign a language to individual customers via the Admin Console, API, Hosted Payment Pages, or Hosted Account Management Pages. Only assign languages that are already enabled on your site.

7

Review and maintain translations

Periodically review your language-specific email templates to ensure content stays accurate and region-appropriate. Check how Recurly formats locale-specific parameters — such as currency and date formats — to avoid miscommunication.


# Sibling pages * [Email templates](https://docs.recurly.com/recurly-subscriptions/docs/email-templates.md) * [Email timezones and timestamps](https://docs.recurly.com/recurly-subscriptions/docs/email-time-zones-and-time-stamps.md) * [Renewal reminder and trial ending notifications](https://docs.recurly.com/recurly-subscriptions/docs/renewal-reminder.md)