AI Language settings
Navigation: WordPress Admin → WooCommerce → AI Assistant → Settings → AI Language
This is shopper-facing reply language, not WordPress admin translations (load_plugin_textdomain). The client cannot force a language; resolution is server-side.
Supported codes: en, es, fr, de, it, pt, ar, bn, hi, zh, ja. Arabic is RTL in the widget.
AI Language
What it does Language the assistant uses with shoppers.
Default value auto — Auto Detect.
Available options
| Value | Label |
|---|---|
auto | Auto Detect |
en | English |
es | Spanish |
fr | French |
de | German |
it | Italian |
pt | Portuguese |
ar | Arabic |
bn | Bengali |
hi | Hindi |
zh | Chinese |
ja | Japanese |
Recommended configuration Auto Detect for mixed traffic. A fixed language for a single-market store.
When to use it Fixed bn if the entire storefront is Bengali and you do not want English replies.
Effect on the frontend LLM is instructed to reply in that language. Fallback messages use the same allow-list. Widget dir is rtl for Arabic.
Dependencies AI for generated replies. Fallback strings work without AI.
Important notes Languages outside this list are not supported. Invalid values become Auto Detect. WordPress locale can seed detection (Language_Catalog::from_wp_locale) but Auto Detect still inspects the shopper message.
Example Auto Detect: a Spanish message gets Spanish replies for that session (if Remember is on).
Remember customer’s language
What it does When Auto Detect is on, keep the language for this chat session unless the shopper clearly switches. Stored only as a language code on the anonymous AI session (ai_language meta).
Default value On.
Available options On / Off.
Recommended configuration On.
When to use it Off if you want every message re-detected (rare).
Effect on the frontend Stable language mid-conversation.
Dependencies AI Language = Auto Detect. Ignored for a fixed language (fixed always wins).
Important notes Not a user-profile setting. Not stored as a name or email.
Example First message in French → rest of the chat stays French until the shopper writes clearly in another allow-listed language.
Fallback Messages
Merchant-configurable static copy when AI cannot reply (or for welcome). This is not a second AI, detector, or search engine.
Keys (max 400 characters each):
| Key | Admin label | When it shows |
|---|---|---|
welcome | Welcome Message | Opening line (unless Appearance Welcome Message is customized — a saved widget greeting overrides language-aware welcome) |
ai_unavailable | AI Unavailable | Provider missing/error when a turn needed the model |
no_products | No Products Found | Catalog search returned nothing |
error | Error Message | Generic failure |
Default value Built-in strings for all 11 languages (English example: “Hi! How can I help you find the right product?”). Empty/reset restores defaults.
Available options Per-language textareas. Auto Detect has no extra language row; the resolved code picks the map. Reset clears only ai_fallback_messages, not other settings.
Recommended configuration Keep defaults unless you need brand voice.
When to use it Translate or tone-match fallbacks to your brand.
Effect on the frontend Exact strings from GET /aiwsa/v1/config → fallbackMessages.
Dependencies None.
Important notes Appearance Welcome Message (widget_greeting) if saved overrides the language-aware welcome.
Example Bengali store: set No Products Found to a custom Bengali sentence; Reset restores the built-in Bengali default.