Multi-Language
How to add languages and translate storefront content in Stilmerce.
Multi-Language
How Locales Work
Each language gets its own URL prefix:
/tr/ Turkish
/en/ English
/ar/ Arabic
/de/ GermanThe locale selector in the storefront header lets customers switch. The selection persists in the URL — bookmarks and shared links carry the language.
Adding a Language
- Go to Admin → Settings → Languages
- Click Add Language
- Select a language code and set it as active
- Set it as default if needed
Translating Admin-Entered Content
Product names, descriptions, and prices are set in the admin panel. To add translations for admin-entered content:
Go to Admin → Settings → Content Translations. This covers:
- Brand names
- Option group names and values (e.g. "Color" → "Renk")
- UI banners and sliders
- Navigation menus
- Static pages and blog posts
- Service package names
The translation is looked up at request time based on the locale in the URL. If no translation exists for a field, the default language value is shown.
System Translations (UI Labels)
The storefront UI labels (buttons, headings, error messages) use static translation files at front/src/messages/{locale}.json. These cover the interface, not the product catalog.
The admin panel has its own interface translations in admin/src/messages/{locale}.json.
AI Translation Drafts
If AI Core is active, go to Admin → Settings → Content Translations and click Draft with AI on any untranslated entry. The draft is held for review — nothing is published until you confirm it.
Right-to-Left (RTL)
Arabic (ar) and other RTL languages are supported. The storefront applies dir="rtl" and mirrors the layout automatically when an RTL locale is active.