Category: Storefront · Min plan: Unlimited plan only · Slug: multi-language

Serve your storefront in both Arabic and French, each on its own indexable URL, with a customer language selector.

Arabic and French — that is the complete set. There is no way to add English, Spanish, or any other language, so don't buy the Unlimited plan expecting one.

The storefront chrome translations are provided and maintained by DZBuild, not by you: they are complete and consistent for both languages out of the box.

Once activated, every storefront page renders a small language selector with the languages you enabled.

Each language has its own URL. Your store's primary language stays on the bare path, and the other language is served under a language prefix:

The selector navigates to that URL rather than re-rendering the page in place. When the customer lands on the Arabic version the entire layout flips to RTL automatically; the French version renders LTR.

Because the language now lives in the URL, a returning visitor who bookmarks or re-opens /fr/... stays in French — while someone who re-enters your bare domain gets your primary language again.

📝 Note

Browser language auto-detection currently has no visible effect on normal pages. A visitor with a French browser landing on your bare store URL still gets your store's primary language. The detected preference is stored in a 30-day cookie that is only honoured on the order-success / thank-you page. Visitors reach the other language by clicking the selector or by opening a prefixed URL directly.

This is the strongest reason to activate the add-on. Because each language is a real URL, DZBuild emits hreflang alternates for every enabled language plus an x-default pointing at the bare path, on every storefront page (product, category, listing, cart, checkout and home). Landing pages don't carry hreflang alternates. Google indexes both versions separately, so a single store can rank for both Arabic and French queries on the same products.

And because the language is in the path rather than in a cookie, multilingual pages keep full CDN edge caching — there is no speed penalty for turning this on.

⚠️ Warning — Keep both language toggles on

These two toggles are the complete language list. Because there are only two languages, switching either one off leaves a single language — which switches the whole add-on off: the selector disappears and the /fr/ URLs stop resolving. Your store still serves its own primary language (that comes from your store setting, not from these toggles), but you lose the multi-language feature entirely.

The add-on translates the storefront chrome — navbar, cart, checkout strings, buttons, generic labels.

Product titles, descriptions and category names are not translatable today. They render exactly as you typed them on both language URLs. There are no per-language product or category fields anywhere in the dashboard.