product icon

How to Customize Instant Chat Language Files

Articles related to customization are written for a technical audience who have experience in web development. Knowledge of HTML, CSS, and JavaScript are required.

The Instant Chat client is available in more than 25 languages. Follow the instructions in this section to add additional languages or otherwise customize the text and messages used during Instant Chat.

  1. Download the following JavaScript files, as required:
    1. If you are only using Instant Chat in Chat-only Mode (for example, on mobile platforms), download
    2. If you also want to use Instant Chat with the Rescue Applet, download


  2. Add, delete, or redefine languages and edit text as required:


    Sample language definition oLangNameArray["en"] = "English";

    The file must contain at least one language definition, and must always include English.

    If you want to have additional languages, you must customize the language drop-down in the CSS. For information about supported languages, see How to Track the Language of Customers with the Channel Form.

    Sample string oLangChatModeArray["ENDED_SESSION"] = "<en>$1 has ended the session.</en><fr>$1 a fermé la session.</fr>...

    You must not change the key definition.

    In this sample, ENDED_SESSION is the key definition.

    The language codes used in language definitions must match the codes used in the hash table.

    Variables (such as $1, $2, etc.) can be deleted.

  3. Host the edited file(s) together with your Instant Chat CSS.
  4. Add the following parameters to your self-hosted HTML:


    ICLoader.HostedLanguagesForChatOnlyMode = "http://[YourSite]/LanguagesForChatOnlyMode.js"; ICLoader.HostedLanguagesForAppletMode = "http://[YourSite]/LanguagesForAppletMode.js";

Article last updated: 27 September, 2022