Getting Started

Building Blocks

Subscription Features




Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages


Reports and Analytics

Attach Additional Data


Open Source Resources

Other Features

API Integration

Third Party Integrations

Configure Multiple Languages 

Localization is the process of adapting the content you will be sending to your customers to their locale. (Localization is also referred to as ‘L10n'. The term ‘i18n' is also used to refer to the process of making the system Internationalization-ready to support different locales)

Translating the language is only one of several steps as part of the localization process. In addition to translation, this process includes:

  • Translating the content to suit your local market
  • Formatting currency as per the locale standard (comma, decimal separator, currency symbol placement etc)
  • Formatting Dates

If you are selling to customers around the world, and would like to communicate with them in their native languages, the Localization feature is for you.

  • Addresses and contact / phone numbers are not localised.
  • Only UTF-8 charset is supported

Locales Supported 

Chargebee supports a list of locales, and based on the locale selected, Chargebee will do the following:

  • Translate the text
  • Customize the format in which the dates are displayed
  • Format currency notations

Check out the list of locales supported by Chargebee.

How Locales are set for Customers 

When you set a locale for a customer or customers, their entire billing experience is tailored to their local language. Chargebee will

  • Display the details in a different language automatically or
  • Allow you to set a locale for your customer or
  • Allow your customers to choose a locale/language for themselves

Depending on your implementation, you can set a customer's locale in the following ways:

If you are a Web Interface user, you can enter the Customer locale while creating the customer or update the locale for an existing customer.

If you are a Hosted Page user, the locale will be set based on the following:

  • Chargebee will identify the browser's locale (You can enable / disable this option from Settings > Field Configurations > Languages) or

  • Chargebee will show a list of languages and your customers can select from the list, as seen in the screenshots below:


You can enable / disable the option to select a locale in the checkout page from Settings > Field Configurations > Languages


If you are a Hosted Page + API user and embedded Chargebee hosted pages as an iframe in your site, you can set the locale via the checkout new subscription   API.


Checkout content in the iframe will not be localised based on the browser locale. You should set the locale via the API as mentioned above.

If you are an API user you can use the following API calls to set or update the locale for a customer:

  • For new customers: You can use the Create a Customer   API to set the locale.

  • For existing customers: You can use the Update a customer   API to update the locale for existing customers.

If you have enabled the Customer Portal, your customers can login and set the locale themselves. They can do this by navigating to the Edit Account Details page in the Customer Portal and selecting a locale from the menu there.

Chargebee will display a list of languages in the customer portal. Your customers can select a locale from the list.


Invoices and credit notes created subsequently will only use the locale set for the customer.

What is Localized in Chargebee 

Chargebee localizes the following:

  • Invoices (the Invoice PDF copy sent out to your customers)

  • Credit Notes (the Credit Note PDF copy sent out to your customers)

  • EMAIL Notifications

  • Hosted Pages (Checkout pages)

  • Customer Portal

  • Invoices/Credit Notes once created in a particular language cannot be changed.
  • When you have setup localization, translation will not be applied in Chargebee's web interface. Chargebee web interface will always display content in English only.

Languages supported by Chargebee 

Chargebee provides default translation for a set of languages, the translation of which will be displayed in Invoices/ EMAILs etc. Additionally, for other languages, Chargebee will allow you to provide all the translations which will be used for communication; here's the detailed summary:

[CASE 1]: Languages translation provided by Chargebee [CASE 2]: Language translation not provided by Chargebee
Chargebee has default translation for the following languages:







Other than the languages supported (such as English, French, German, Italian, Portuguese), Chargebee can support localisation for other languages if you can provide the translation for all the terms you are in the required language.

You can provide the translation and upload the language translation pack for other languages not in the list.
What does this mean for you?

Translation for default text is already available and you need to provide translation for anything created new, such as product names (Plans, Addons), if the EMAIL Notification text etc.

List of data translated and maintained by Chargebee (Default):

  • Hosted Pages label attributes, error messages, info and warning messages
  • Invoice and Credit Note fields
  • EMAIL Notifications

Data which you can change for which you should provide translation:

  • Plan Name
  • Addon Name
  • EMAIL Notification text (if default text is changed)
  • Custom Fields

What does this mean for you?

Default translation is NOT available for any text in the system. You have to provide translations for all the text.

Chargebee will display the translation text you upload.

For instance, if you want to send out invoices/emails in Turkish or Japanese, you can upload translations for the terms you are using in Turkish or Japanese and the translations will be displayed for your customers to see.

Language Pack 

You can choose the languages in which you want to communicate with your customers and customize the content for each language.

Chargebee provides translation for a set of languages out of the box, which means you spend minimal or no time in translation.

But Chargebee also supports other languages, for which you can provide the translation text.

In order to upload the translation text, you should download the language pack and enter the details.


If you are enabling only one (1) language, then the language pack is not required. You can enter the translation text in the web interface itself. If you are enabling more than one (1) language, then you should provide the translation text in the language pack.

CASE 1: Languages with translation available in Chargebee 

Chargebee language pack consists of a set of folders and each folder contains a set of files for which you should provide the translation (or not):

  • Chargebee provides all the fields, alerts, error messages, info text etc in the language pack.

  • You can provide the translation values (in the ‘VALUE' column), see sample below:

Mandatory Folder

Translation is required for all files in this folder

Plans You should provide the translation in the required language for the Plans you create
Addons You should provide the translation in the required language for the Addons you create
Custom Fields If you have added custom fields for Customers, Subscriptions, Plans & Addons, you should provide the translation text

Optional Folder

Default translation is available, but you can edit the translation if required

Hosted Pages and Customer Portal Translations for the text, error messages etc displayed in the Hosted Pages and Customer Portal is available by default, but you can edit the translation, if required
EMAIL Notifications Translations for the Welcome EMAILs, Reminder EMAILs is available by default, but you can edit the translation, if required

CASE 2: Languages with translation not available in Chargebee 

In this scenario, you should provide the translation for all the files and then upload the language pack into Chargebee.

Which means, in addition to the ‘Mandatory' and ‘Optional' folders, you should provide the translation text for the following as well.

Internal Folder

Default translation not available

Static text Translation for static text such as "Total" or "Subtotal" should be entered
Invoice, Credit Note labels or attributes Translation for field labels shown in Invoice, Credit Notes such as ‘Name', ‘Date', ‘Address' should be provided

Steps to Configure Localization 

Step 1: Download the language pack and provide the translations

Navigate to Settings > Languages and download the Language pack


In case you can't find the desired language in the list, please contact . We will add the language in the list for your site from the backend and then you can start from Step 1.

Step 2: Upload the pack

  • Enter the translation text in the language pack.

  • Once the translation text is entered, upload the pack (only .zip format is supported).

  • In case, there are errors, the errors will be displayed and you can review the errors and upload the updated version.

Step 3: Enable the Language

  • Once the language pack is uploaded, you can enable the language.

  • Once the language is enabled, the customers will start receiving invoices, emails etc or can view the checkout pages and portal in that language.

Step 4: Test the translation

We recommend you test the translation after you have uploaded the language translation pack and enabled the language - we suggest you verify the invoices and credit note pdf copies, emails, hosted pages, customer portal.

Here's a sample how an invoice looks like (in German)

  • Text in green color denotes default translation provided by Chargebee.

  • Text in yellow is the translated text you have provided in the language pack.

What role does ‘Default Language' play 

You can configure a list of languages you want to communicate with your customers in.

So when you sign up for the Chargebee site, you will be asked for a ‘Preferred language'. Once selected, this language will act as the default language. You can add additional languages to the list as well.

The default language will be used in the following scenarios:

  1. If you have not set a locale for a customer, invoices and emails etc will be sent in the default language

  2. After you have uploaded the language file, incase you have missed the translation text, Chargebee will use the default language for communication

If you have more than 1 language enabled (say Spanish and French and French is the default), one language will act as the default (French). If translation text is not available for a language (say Spanish), then the content will be sent in the default language (in this case, French)

If you have only one language, Chargebee will consider that as the default language

  • For new users, you cannot change the default language, once you have selected a language as default during signup. Please contact  and we will assist you in-case you want to switch the default language.

  • For existing users, ‘English' will be the default language by default


I'm a merchant who wants to use ‘Spanish' for my customers, what should I do?

Spanish is one of the languages for which Chargebee provides translation out of the box (see complete list here), hence you need to enter the text (in Spanish) in the web interface wherever applicable such as

  • Plans,
  • Addons
  • Custom Fields

and enable Spanish in the Settings > Language screen.

I'm a merchant who wants to communicate in ‘Japanese' with my customers, what should I do?

Translation for Japanese is not available by default in Chargebee (see complete list here), so you need to do the following:

  • Upload the Language pack, with translation text in Japanese
  • Contact  to add Japanese in the list of languages for your site
  • Enable the Japanese in the Settings > Language screen

Do I need separate language packs for each of the languages that Chargebee supports?

No, you can download one language pack which will consist of all the languages. You can provide the translation for the desired languages and upload the entire language pack back into Chargebee.

I forgot to set a customer's locale and an invoice has been generated. This invoice is in English. Is there any way in which the invoice can be converted to French?

No, your invoice cannot be converted to French. Once an Invoice is generated in a particular language, it cannot be altered in any way.

What will happen to the old invoices if I disable a language (say, French) through language settings?

The old invoices that were in French will stay that way. Once an invoice is generated, it cannot be altered.

I forgot to translate my plan names in my German language pack. What will the invoice look like for the customer whose locale is set as German?

The entire invoice will be in German. However the plan description in the invoice will be in English. Chargebee reverts to the default language when it cannot find a translation in the language pack.

I forgot to translate the text in my Welcome Email (in my German language pack). What will the email look like?

Chargebee will refer to the default translation available for all email notifications. In case you've forgotten to translate an email, Chargebee will it's default translation (of your Welcome Email in German) to your customer.

I need to stop sending emails, and invoices in another language. Do I need to reset the site locale for every customer?

No, you don't need to change the locale of customers individually. Navigate to the Settings > Languages page to deactivate a language.

Can I activate a language after I have deactivated it?

Yes, as long as you have a language pack, you can activate a language

Can I update my language pack after I have activated a language?

Yes, you can update the translation details. Chargebee will use only the latest version of a language pack for translation.

Can I change the default language which was set during signing up for Chargebee?

Yes, you can send a request to  and we will switch the default language in case you have multiple languages enabled.