Skip to main content

Multi-language support

ShopGuide has two genuinely different language capabilities, and it's important not to conflate them: the widget's own UI chrome, and the AI's actual chat responses.

Widget UI: English, German, Dutch

The buttons, labels, modals, and status messages that make up the chat widget itself (tool-call status text, the guided discovery overlay, the sources/citations panel, the product comparison view, the footer attribution, and the disclaimer text) are translated into three languages: English (default), German, and Dutch. This is a fixed, hand-maintained set of roughly 90 translation keys — adding a new UI language means adding a new translation set to the codebase, not a setting merchants can turn on themselves.

The widget determines which of the three to show based on the shop's configured content language (falling back to English if the shop's language isn't one of the three).

AI chat responses: a much broader set

Separately from the widget's UI, the AI's actual conversational replies are controlled by a language instruction that's added to every response. This instruction supports a much larger set of languages — including major European, Middle Eastern, South and East Asian, and African languages — detected from the customer's messages or the shop's configured language, with English as the fallback when detection is inconclusive.

In practice this means: a customer can type in a language the UI chrome was never translated into, and the AI will still attempt to reply in that language — but the surrounding widget buttons and labels stay in English, German, or Dutch.

What this isn't

There is no right-to-left (RTL) layout support in the widget, no translation-memory system, and no human-translation review workflow — translations for the three UI languages are maintained directly in the codebase by the ShopGuide team. Currency, tax, and shipping display are handled by Shopify Markets/your theme, not by ShopGuide.

Next steps