Configure Hosts for Sites with Multiple Languages

This topic applies to

Applies to

SuiteCommerce Advanced


The hosts array within the Configuration.js file provides language-specific and currency-specific site support for multiple languages and currencies. This functionality is disabled by default. To enable this feature, configure the host for each language and define specific properties.

Follow the correct configuration procedures below, depending on your implementation. For information on configurable properties, regardless of your implementation, see Hosts Subtab.

This topic applies to

Applies to

SuiteCommerce | SuiteCommerce Advanced

Configure Hosts with the SuiteCommerce Configuration Record

This procedure applies to SuiteCommerce and the Vinson release of SCA or later.

To configure the hosts array:

  1. Select the domain to configure at Setup > SuiteCommerce Advanced > Configuration.

  2. In the SuiteCommerce Configuration record, navigate to the Multi-Domain tab and the Hosts subtab.

  3. Set feature properties as required.

  4. Save the Configuration record.

This topic applies to

Applies to

SuiteCommerce Advanced

Configure the hosts Array

This procedure applies to the Mont Blanc and Denali releases of SCA.

To configure the hosts array:

  1. Follow the steps presented in Set Up NetSuite for Localized Content.

  2. Set up a hosted domain for each additional language on your site. See Domains for details on how to create new hosted domains.

  3. Setup the SspLibraries module for customization.

    See Customize and Extend Core SuiteCommerce Advanced Modules for detailed information.

  4. Open the Configuration.js file in the newly created module.

  5. Within the hosts array, define a unique host for each location using the title property.

  6. Define the currencies and languages arrays for each host using the properties defined in this section.


    For detailed information on the hosts array for Mont Blanc and Denali implementations, see Hosts Array Parameters (pre-Vinson).

    For example, you want to set up a multiple-language site that contains three geographic locations: the United States, South America, and France. For each location, you want to define specific currencies and languages according to the following table:




    United States

    U.S. Dollar


    South America

    U.S. Dollar

    Argentinian Peso

    Uruguayan Peso






    U.S. Dollar


    You set up NetSuite to allow multiple languages and enable the applicable languages and currencies. You then set up hosted domains for each translated language.

    The following code snippet shows what your customization might look like.

    , hosts: [ { title:'United States' , currencies:[ { title:'American Dollars' , code:'USD' } ] , languages:[ { title:'English' , host:'' , locale:'en_US' } ] } , { title:'South America' , currencies:[ { title:'American Dollars' , code:'USD' } , { title:'Peso Argentino' , code:'ARS' } , { title:'Peso Uruguayo' , code:'UYU' } ] , languages:[ { title:'Spanish' , host:'' , locale:'es_ES' } , { title:'Portuguese' , host:'' , locale:'pt_BR' } , { title:'English' , host:'' , locale:'en' } ] }, { title:'French' , currencies:[ { title:'Euro' , code:'EUR' } , { title:'American Dolars' , code:'USD' } ] , languages:[ { title:'French' , host:'' , locale:'fr_FR' } ] } ]
  7. Deploy the module to your site.