1. Commerce
  2. System Management
  3. Site Configuration
  4. Configuration Properties Reference
  5. Multi-Domain Tab
  6. Hosts Subtab

Hosts Subtab

These settings configure information about each host for websites with multiple languages or regions. You must define a host for each language.

More Information: Localization

List of Hosts

This lets you set the host for each translated site. Use the following list to add your hosts by ID. For example, you may set up one host for English and U.S. Dollars, and another for English and French with both U.S. Dollars and Euros.

Important:

Each language must have its own domain.

Each host requires the following:

  • Host ID – the host address name for the translated content. This name must match the hosted domain you set up for the associated language. For more information about setting up domains, see Domains.

  • Language – the languages available for the associated host location.

  • Language Title – the label for the currency in the Location dropdown on your site.

  • Language Domain – the domain name for this language. This must exactly match the hosted domain for the associated language.

  • Currency – the label for the currency in the Location dropdown on your site.

  • Subsidiary – the subsidiary for the host.

  • Location – the location for the host.

IDs

multiDomain.hosts
multiDomain.hosts.host
multiDomain.hosts.language
multiDomain.hosts.languageTitle
multiDomain.hosts.languageDomain
multiDomain.hosts.currency
multiDomain.hosts.subsidiary
multiDomain.hosts.location

UI location

Multi-Domain > Hosts

ID (pre-Vinson)

hosts

JSON file

Languages.json

Configuration file (pre-Vinson)

Configuration.js

Hosts Array Parameters (pre-Vinson)

In pre-Vinson implementations, the hosts array, located in the backend Configuration.js file, maps languages and currencies to specific hosts. This array requires a title property and both the currencies and languages arrays, as shown below.

Note:

The hosts array contains sample code that's hidden within a multi-line comment block. Remove the comment tags to view it, but you need to customize the properties for your site as explained below.

  • title (string) – the label for the location in the Location dropdown on your site.

  • currencies (array) – the currencies available for the associated host location.

    • title (string) – the label for the currency in the Location dropdown on your site.

    • code (string) – the code for the location. This maps the currency code with the specific host location and must exactly match the three-letter International Standards Organization (ISO) currency code symbol defined in the backend, or the currency won't appear in the list. See Currency Management for more information.

  • languages (array) – the languages available for the associated host location

    • title (string) – the display label of the currency within the Location drop-down selector on the website.

    • host (string) – the host address name for the translated content. It has to match the hosted domain you set up for that language. For more information about setting up domains, see Domains.

    • locale (string) – the country and culture code for the language per ISO standards (ISO 639 and ISO 3166 respectively). This must match the locale property defined in the backend, or the language won't appear in the list. Example: en_US or es_ES.

      Your website must have a unique locale for each hosted domain and a unique domain for each language.

IDs (pre-Vinson)

hosts
hosts.title
hosts.currencies
hosts.currencies.title
hosts.currencies.code
hosts.languages
hosts.languages.title
hosts.languages.host
hosts.languages.locale

UI location

None

Configuration file (pre-Vinson)

Configuration.js

Related Topics

General Notices