Docs

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.

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

Languages Supported 

Chargebee supports a list of languages, and based on the language 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 languages supported by Chargebee.

How Languages are set for Customers 

When you set a language 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 language for your customer or
  • Allow your customers to choose a language for themselves

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

In the Chargebee user interface, you can select the language while creating the customer or update the language setting for an existing customer.

If you have not set a language, Chargebee picks the browser's locale and displays content in the appropriate language. You can enable/disable this option:

Single Page Checkout: Navigate to Settings > Configure Chargebee > Checkout & Portal > Field Configurations > Languages

In-app Checkout: Navigate to Settings > Configure Chargebee > Checkout and Self serve portal > Use browser locale if customer locale is not specified

If you are using Single Page Checkout, Chargebee will show a list of languages and your customers can select from the list, as seen in the screenshots below:

In Single page Checkout, you can enable/disable the option to select a locale in the checkout page from Settings > Configure Chargebee > Checkout & Self-Serve Portal > Languages.

A few points to note:

  • If you are using a default theme provided by Chargebee, ensure you are on the latest theme (version which is 2.7 or higher)
  • If you are using your own theme, please refer the steps  explained in this solution article

In case you are using Checkout + API and embed the single page checkout 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 localized 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 language themselves. They can do this by navigating to the Edit Account Details page in the Customer Portal and selecting a language from the menu there.

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

Note

Invoices and credit notes created subsequently will only use the language 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

  • Checkout pages

  • Customer Portal

Note
  • 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 displays content based on your app language.

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:

English

French

German

Spanish

Italian

Portuguese

The translation for English, French, German, Italian and Portuguese is taken care by Chargebee. But, if you wish to use a different language for localization, then you will have to provide the translation and upload the language translation pack for the desired language.
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):

  • Checkout 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.

Enable Multiple Languages in Chargebee 

You can send email notifications to your customers in the language of your choice.
Login to your Chargebee site and navigate to Settings > Configure Chargebee > Languages, and add the language of your choice from the list given.

Note

Contact support  to list a language not mentioned in Chargebee.

Say, you chose French to send emails to your customers. You'll find options to either Enable Draft or Activate the language for your Chargebee site.

Enable Draft option will allow you to edit the content of the email notifications and test them before sending it over to your customers.

Activate Language will allow you to send the emails to your customers with the content you have set.

Configuring languages 

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.

Chargebee also supports other languages, for which you need to provide the translation text.

To change or add the translation text, you should download the language pack and enter the translation details and upload it back to your Chargebee site. The steps for it are explained in separate sections below for languages with and without default translation provided by Chargebee.

Language Pack 

Chargebee language pack consists of a set of folders and each folder contains a set of files for which translation can be provided.

Note

If you are enabling only one 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 language, then you should provide the translation text in the language pack.

Translation files 

There are three folders that contain the translation files:

  • Mandatory
  • Optional
  • Internal

All these three folders are available (regardless of whether Chargebee provides default translation for the language or not) when the downloaded language pack is unzipped.

You can provide the translation in the ‘VALUE' column of each file. Here's a sample of it:

Mandatory folder 

It contains the customer-facing fields such as plan name, addon name, custom fields, etc. You need to provide translation for all the files in this folder.

The translation files included in this folder are:

  • Plans
  • Addons
  • Custom fields
  • Invoices
  • Coupons
  • Reason codes
  • Organization details

Optional folder 

This folder contains files with field names that are already translated if default translation is provided for the language by Chargebee. You can choose to override it. For other languages, however, there will be no pre-translated values and you need to provide them.

The translation files included in this folder are:

  • Checkout
  • Self-serve portal

Internal folder 

This folder contains files with all the static fields. This includes customer-facing verbatim such as "Total", "Tax" etc. For languages with default translation provided by Chargebee, the translation values are already provided in each file. You can change it if need be. For other languages, you need to provide the translation.

The translation files included in this folder are:

  • Credit notes
  • Line items
  • Quotes
  • Emails
  • Checkout
  • Self-serve portal
  • Invoices
  • Country names
  • Enum values

There are two possible scenarios.

  1. Languages with translation available in Chargebee: In this scenario, Chargebee provides translation for all the pre-configured fields, alerts, error messages, information text, and more. This translation is provided by the language pack.

    a. Mandatory Folder: Translation values are required for all files in this folder .
    b. Optional Folder: Translation is optional for files in this folder since default translation values are provided already in the Optional folder.
    c. Internal folder: Translation is not required for files in this folder since default translation values are provided already in the Internal folder. You can still change the values if required.

  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. You need to provide translation values for all files in the Mandatory, Optional, and Internal folders.

Follow the steps below to add translation files to a language pack:

Step 1: Choose the language 

  • Navigate to Settings > Configure Chargebee > Languages.

  • Choose the language from Available Languages and click Add. View the list of supported languages.

  • If you want to make changes to Chargebee's default content, choose Enable Draft.

  • Else you can activate the language. Chargebee's translated default content will appear in your email, invoices, and more once activated. Changes can be made even after activating the language.

Step 2: Download the language pack and provide the translations 

  • Click Download Language Pack.

  • Chargebee will send an email with a URL to download the language pack. This URL will expire in 60 minutes from the time you receive it.

  • The link will lead to downloading a file in ZIP format.

  • Unzip and enter the translation text in the language pack.

Step 3: Upload the language pack 

  • Click Upload Language Pack to upload the language pack with the translation text (only ZIP format is supported).

  • In case, there are errors, you will receive an email with all the errors listed in a CSV file attached to it. Click Download error list to resend the email to your email address.

Step 4: Activate the Language 

If you had chosen to Enable Draft in Step 1, you need to enable the language using the Activate option.

  • Once the language is activated, your customers will start receiving invoices, emails, and more, and can view the checkout pages and portal in the language.
Note

If you choose to Deactivate a language, emails, invoices and credit notes will be sent to your customers in your Chargebee site's Primary language.

Test the translation 

We recommend you test the translation using the Enable Draft option. After you have uploaded the language translation pack and enabled the language, we suggest you to verify the invoices and credit note PDF copies, emails, checkout pages, and customer portal.

Here's a sample of how an invoice appears (in German)

  • The Text in green color denotes the default translation provided by Chargebee.
  • The text in yellow is the translated text you have provided in the language pack.

Primary Language of your Chargebee Site 

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:

  • If you have not set a locale for a customer, invoices and emails etc will be sent in the default language
  • After you have uploaded the language file, in case 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
Note
  • For new users, you cannot change the default language, once you have selected a language as default during sign up. Please contact support  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

List of Languages Supported 

Here is a list of the languages supported in Chargebee.

Language

Translation provided out of box?

English

Yes

French

Yes

German

Yes

Italian

Yes

Portuguese

Yes

Spanish

Yes

Ukrainian

No

Danish

No

Turkish

No

Finnish

No

Slovene

No

Chinese

No

Swedish

No

Japanese

No

Russian

No

Dutch

No

Lithuanian

No

Latvian

No

Estonian

No

Polish

No

Indonesian

No

Czech

No

Slovak

No

Korean

No

Norwegian

No

Romanian

No

Hungarian

No

Bulgarian

No

Thai

No

Vietnamese

No

FAQ 

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 > Configure Chargebee > Languages 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:

  • Contact support  to add Japanese in the list of languages for your site.
  • Upload the Language pack, with translation text in Japanese.
  • Enable the Japanese in the Settings > Configure Chargebee > Languages 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 use 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 > Configure Chargebee > 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.

Does Chargebee support Arabic and Hebrew languages?

No, Chargebee does not support Arabic and Hebrew languages. Currently, we do not support RTL(right to left) scripts.

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

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

  • 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

Checkout Pages and Customer Portal Translations for the text, error messages etc displayed in the Checkout Pages and Customer Portal is available by default, but you can edit the translation, if required
Email Notifications Click here to know how to configure language pack if you are using Chargebee's Email Notifications

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
Was this article helpful?
Loading…