Multiple markets & languages

If you sell across several countries, currencies, or languages, Dialog adapts to each shopper on its own. It answers in their language and shows prices in their market’s currency (in the conversation and in every product recommendation), so the assistant feels native to whichever storefront the shopper is on.

There’s nothing to configure inside Dialog. It reads your existing market and language setup from your store and keeps it in sync.

How it works

Two things adapt to each shopper, independently:

Language: the assistant converses in the shopper’s language, and product titles and descriptions in its recommendations use your published translations.
Price & currency: the prices shown in recommendations and in the conversation use the shopper’s market currency and pricing.

Dialog picks up the shopper’s language and market from the storefront they’re browsing: a visitor on your French store gets French answers and euro prices. But the two are independent, if your shop allows a shopper to browse in one language while priced in another market (French language and USD currency), Dialog will match accordingly.

Shopify

On Shopify, Dialog reads everything from your Shopify Markets and your published store translations, automatically, on every catalog sync. There’s no Dialog-side configuration.

What Dialog uses:

Your markets: the markets you’ve enabled in Settings → Markets and the countries in each. Dialog groups shoppers by market exactly the way Shopify does.
Per-market prices: the price Shopify serves for each market (market price adjustments or price lists). Recommendations and the assistant show each shopper their market’s price and currency.
Published translations: the languages you’ve published for your store (through Shopify’s Translate & Adapt app or a translation app). Product titles and descriptions, and the assistant’s replies, appear in the shopper’s language.

To get the most out of it, make sure on Shopify:

Your markets are set up with the right countries in each.
Prices are configured for every market you sell in.
Translations are published for every language you sell in: Dialog only reads published translations, not drafts.

Good to know:

Each market maps to one currency and price set. If a market groups several countries (for example an EU market covering FR, DE, and ES), shoppers in all of them see that market’s prices.
Changes to your markets, prices, or translations are picked up on your next catalog sync and as products update: there’s no separate step for Dialog.

PrestaShop

On PrestaShop, Dialog reads everything from your store’s languages and your tax rules, automatically, on every catalog sync. There’s no Dialog-side configuration.

A shopper in a country with a different VAT sees that country’s price, exactly like your storefront.

What Dialog uses:

Your installed languages: the languages enabled in International → Localization → Languages, and the product translations you’ve entered for each. The assistant replies in the shopper’s language, and recommendations show translated product and variant names.
Your tax rules: the per-country VAT set up in International → Taxes. Dialog computes each product’s price for the shopper’s country through PrestaShop’s tax engine, so recommendations and the conversation show the country-correct amount.
Your tax display: whether your storefront shows prices tax-included or tax-excluded. Dialog shows the shopper the same, so its prices always match your storefront.

To get the most out of it, make sure on PrestaShop:

Your languages are installed and active, with product translations filled in for each in the back office.
Your tax rules are configured per country for the markets you sell in: that’s what drives per-country prices.
The countries you sell to are enabled in International → Localization → Countries.

Good to know:

Changes to your languages, translations, or tax rules are picked up on your next catalog sync: there’s no separate step for Dialog.

Custom catalog

With a custom catalog you declare markets and languages inside the catalog JSON you upload: Dialog reads them from the same file it already ingests. The full shape is in the catalog schema; here’s what to add for markets and languages.

Markets & prices: declare your markets once at the top level, each with a name and its countries (uppercase ISO 3166-1 alpha-2 codes). Then, on each variant, make price an array: one entry without a market (the default) plus one entry per market, tagged with the market name. compareAtPrice follows the same shape.

{
  "markets": [
    { "name": "Europe", "countries": ["FR", "DE", "ES", "IT"] },
    { "name": "United Kingdom", "countries": ["GB"] }
  ],
  "products": [
    {
      "id": "prod_001",
      "variants": [
        {
          "id": "var_001",
          "price": [
            { "amount": "29.99", "currencyCode": "USD" },
            { "amount": "25.99", "currencyCode": "EUR", "market": "Europe" },
            { "amount": "21.99", "currencyCode": "GBP", "market": "United Kingdom" }
          ]
        }
      ]
    }
  ]
}

Languages: add translations on products (title, description) and on variants (displayName), keyed by lowercase locale code (fr, es, …). Option names and values can be translated too.

{
  "translations": {
    "fr": { "title": "T-shirt en coton premium", "description": "..." }
  },
  "variants": [
    { "translations": { "fr": { "displayName": "T-shirt rouge - Taille M" } } }
  ]
}

Good to know:

market on a price is the market name, not a country code, and always ship one default price entry with no market.
Each country belongs to a single market; countries grouped in the same market share its price and currency.
Markets and translations are optional and additive: a single-market, single-language catalog keeps working with one price and no translations.
Changes take effect on your next catalog upload.