Configure Hosts Array for Multi-Language in NetSuite SCA 2023.2
Step-by-step guide to configure the hosts array for multi-language support in NetSuite SCA version 2023.2. Configure the hosts Array
Configure the hosts Array
Configure the hosts Array
This procedure applies to the Mont Blanc and Denali releases of SCA.
To configure the hosts array:
-
Follow the steps presented in Set Up NetSuite for Localized Content.
-
Set up a hosted domain for each language on your site. See Domains for details on how to create new hosted domains.
-
Set up the SspLibraries module for customization.
See Develop Your SCA Customization for detailed information.
-
Open the Configuration.js file in the newly created module.
-
In the
hostsarray, define a unique host for each location with thetitleproperty. -
For each host, define the
currenciesandlanguagesarrays using the properties in this section.Note:
For detailed information on the hosts array for Mont Blanc and Denali implementations, see Hosts Array Parameters (pre-Vinson).
For example, say you want to set up a multi-language site with three locations: the United States, South America, and France. For each, you could define specific currencies and languages as shown in the table below:
Location
Currencies
Languages
United States
U.S. Dollar
English
South America
U.S. Dollar
Argentinian Peso
Uruguayan Peso
Spanish
Portuguese
English
France
Euro
U.S. Dollar
French
You set up NetSuite for multiple languages and enable the right languages and currencies, then create hosted domains for each translated language. The locale string must specify the country code and culture code for each language, using ISO standards (ISO 639 and ISO 3166 respectively). For example: en_US or es_ES.
Here's an example of how your customization might look:
json1, hosts: [2 {3 title:'United States'4 , currencies:[5 {6 title:'American Dollars'7 , code:'USD'8 }9 ]10 , languages:[11 {12 title:'English'13 , host:'en.mysite.com'14 , locale:'en_US'15 }16 ]17 }18 , {19 title:'South America'20 , currencies:[21 {22 title:'American Dollars'23 , code:'USD'24 }25 , {26 title:'Peso Argentino'27 , code:'ARS'28 }29 , {30 title:'Peso Uruguayo'31 , code:'UYU'32 }33 ]34 , languages:[35 {36 title:'Spanish'37 , host:'sa.mysite.dev'38 , locale:'es_ES'39 }40 , {41 title:'Portuguese'42 , host:'pt.sa.mysite.dev'43 , locale:'pt_BR'44 }45 , {46 title:'English'47 , host:'en.sa.mysite.dev'48 , locale:'en'49 }50 ]51 },52 {53 title:'French'54 , currencies:[55 {56 title:'Euro'57 , code:'EUR'58 }59 , {60 title:'American Dolars'61 , code:'USD'62 }63 ]64 , languages:[65 {66 title:'French'67 , host:'fr.mysite.com'68 , locale:'fr_FR'69 }70 ]71 }72 ] -
Deploy the module to your site.
Frequently Asked Questions (4)
Does configuring the hosts array apply to all NetSuite versions?
Do I need to configure hosted domains when setting up the hosts array?
What information do I need to define for each host in the hosts array?
Are there specific modules I need to use for customizing the hosts array in NetSuite?
Was this article helpful?
More in Localization
- E-Document Certification for Brazil in NetSuite 2026.1
Updated for NetSuite 2026.1, the E-Document Certification feature enhances compliance for Brazilian businesses.
- Brazil Reports SuiteApp for Compliance in NetSuite 2026.1
Updates for Brazil Reports SuiteApp now available in NetSuite 2026.1, including enhanced reporting features.
- Payment Times Report 2025 Configuration in NetSuite 2026.1
Payment Times Report 2025 configuration details now available in NetSuite 2026.1, enhancing compliance with Australian reporting requirements.
- Mexico Complementary Features SuiteApp Enhancements for NetSuite
Explore Mexico Complementary Features SuiteApp enhancements, improving electronic reporting and transaction support.
Advertising
Reach Localization Professionals
Put your product in front of NetSuite experts who work with Localization every day.
Sponsor This Category