Translate Your Webshop (Locales)
Overview
You can offer your webshop in multiple languages (for example Danish, Swedish, Norwegian) by using different locales.
The language shown to a visitor is automatically linked to the currency they select when visiting your site.
Example: If a visitor selects Swedish Kronor (SEK), the webshop will display in Swedish.
Translate with the Translation Manager
Step-by-step
- Go to Settings → Translation Manager
- Click Add New Item
- Add your translation values (see rules below)
- Press Submit
- Review the result on your live website by switching language using the flag in the top right corner
- Repeat for each webshop element that needs translation
Important rules when adding translations
What to enter (Key field)
- Add the keyword or sentence you want to translate.
- The Key field is what connects the translation to the webshop element.
- The Key must exactly match the text used in your Webshop Builder elements, including:
- capitalization
- spacing
Tip for longer sentences: Copy the original text from the webshop builder element into Notes first, then copy it from there into the Key field to avoid formatting issues.
Language requirements (English must always be included)
Always include the English version of the text under:
- EN
- EN-GB
- EN-EU
Then add the translated version in the language(s) you want.
Required vs optional locales
| Locale | Required? | What to put there |
|---|---|---|
| EN | Yes | English (base text) |
| EN-GB | Yes | English (UK variant; use same English text if you don’t localize) |
| EN-EU | Yes | English (EU variant; use same English text if you don’t localize) |
| Other languages (e.g., DA, SV, NO) | No | Your translations |
Finalize and review
After you add/update a translation:
- Click Submit
- Open your website
- Change the language using the flag in the top right corner
- Confirm the translated text appears in the expected webshop element
- Repeat for any other elements that need translation
Import translations with CSV (bulk upload)
If you prefer uploading translations in bulk, you can use Ribbn’s CSV import tool.
Step 1: Start from the Translation Template
Download the template here: Template (Google Sheets link).
Important: Save the template to your computer before editing it.
The sheet contains:
- Key column — must match the text exactly as it appears in your webshop (case-sensitive)
- One column per language — where you fill in translations
Key rules (CSV)
- The Key column must remain exact and unchanged
- Do not change formatting, spacing, or casing in the Key
- Only add/update translations in the language columns
Step 2: Export your sheet as CSV
- In Google Sheets, go to File → Download → CSV (.csv)
- Save the file to your computer
Step 3: Import the CSV into Ribbn
- Open Settings → Translations
- Click Import CSV
- Select your CSV file and upload it
- Ribbn will automatically process and apply the translations to your webshop
Troubleshooting checklist
- Translation not showing up?
- Verify the Key exactly matches the webshop element text (case + spacing).
- Confirm you included English entries for EN, EN-GB, and EN-EU.
- Refresh the page after switching language via the flag in the top-right corner.
- Bulk import didn’t apply correctly?
- Re-check that the Key column wasn’t altered in the template.
- Confirm your file was exported as .csv (not Excel, not PDF).
