Translations

For: comrce staff with the Super Admin roleRequires: The Super Admin roleScreenshots show sample data

The Languages page lists every language the comrce Hub interface offers. As a Super Admin, you add and remove languages here. Corrected texts reach users at their next page load. Open it from Languages, the last entry in the left sidebar.

Its heading reads Translations, and its tab Translations.

What you can do here

See which languages exist and how current they are. Each row shows the code, the language name and the date of the last import. The page at a glance.
Add a language. Add language creates an empty language that users can choose at once. Offer comrce Hub in another language · Adding a language and importing translations.
Import texts. Update translations publishes a CSV file with one column per language. Import translations.
Open a language’s published file. The arrow at the end of a row opens it in a new tab. Every control, explained.
Remove a language. Delete deletes the language and its files. Delete a language.

The screen at a glance

The Languages screen of the comrce Hub admin console, opened from "Languages" at the bottom of the left sidebar; the tab and the heading both read "Translations". At the top right are the buttons "Update translations" and the highlighted "Add language". The table lists seven languages sorted by code with the columns Code, Display name, Updated date and Delete: de German, en English, es Spanish, fr French, it Italian and nl Dutch each show the date of their last import and an arrow button that opens the published file, while pl Polish shows a dash because no file has been imported for it yet. — Every language comrce Hub offers, with the date its texts were last imported. A dash means no file yet.

Region	What it shows	What you do there
Heading, left	Translations	Orientation
Heading, right	Update translations and Add language	Import or add
The table	One row per language, sorted by code	Read dates, open files, delete
Below the table	The count and the page buttons	Move between pages

Offer comrce Hub in another language

A new market or a new team abroad? Add the language first, then import its texts. Until you import them, the new language shows English texts, so nothing appears blank.

Select Add language.
Type the two-letter code into Language code, for example pl.
Confirm with Create at the bottom right of the dialog.

The "Add language" dialog over the Languages screen. It says "Add a new language code to your project (e.g., en, de, fr, en-US)." Below is the highlighted, required field "Language code" with the placeholder "e.g. en or en-US". At the bottom are Cancel and the disabled "Create" button; it becomes active once a code in the right format is typed. — A language starts as a code. Its texts arrive later with a translations import.

The message Language has been added successfully. appears, and the list shows the language with a dash as its date. Every user’s language selector offers it from their next page load. Users who choose it see English texts until you import its column.

Import translations

Select Update translations. The dialog shows the CSV rules and an example.
Select Choose file and pick the .csv file. Its name replaces No file selected.
Confirm with Upload at the bottom right.

The "Update translations" dialog. Under the description "Upload a CSV to Update translations.." a box lists the "CSV format rules": "Column 0: dotted key, e.g. common.ok_button", "Columns 1..N: language codes (e.g. en, de, fr)." and "Max file size: 50 MB." It then shows a "Minimal example (comma-separated):" with three lines starting with key,en,de. Below are the highlighted "Choose file" button with the text "No file selected" beside it, a Cancel button and the disabled "Upload" button. — The dialog states the CSV rules. Pick a file, then upload it to replace the texts of every language column.

On success, the message Translations imported successfully. appears, the dialog closes and the dates of the imported languages change. A refused file shows the reason in red inside the dialog. The import replaces the whole file of each imported language. The rules are in Adding a language and importing translations.

Delete a language

Select Delete in the language’s row.
Confirm in the dialog Delete translation with Delete.
The message Translation deleted successfully. appears and the row disappears.

The confirmation dialog after selecting Delete in the row of pl Polish. The highlighted title reads "Delete translation" and the question below is "Are you sure you want to delete this translation?" At the bottom are Cancel and the confirm button "Delete". Confirming removes the language row and its published text files at once; the dialog does not say that this also removes the language from every user's language selector. — Deleting a language removes its texts and its entry in every user's language selector, without undo.

Never delete en. Every other language is built on English, and without it comrce Hub cannot show texts in any language.

Every control, explained

Update translations

Where

Top right, the first button, Update translations.

What

Opens the import dialog with the rules, an example, Choose file, Cancel andUpload. It accepts .csv files up to 50 MB.

Why

Texts change without a new release of comrce Hub.

Add language

Where

Top right, the second button, Add language.

What

Opens a dialog with one field, Language code. Spaces are removed as you type. A wrong format shows Use ISO code like 'en', 'de', or 'en-US'.. An existing code shows Language code already exists..

Why

A language must exist before its column can be imported.

Table columns and row actions

Column	What it shows or does	Why
Code	The language code in lower case	Matches the CSV column header
Display name	The language name in the interface language	Recognise the language
Updated date	Date and time of the last import with this language, or a dash	Prove that an import arrived
Delete	Deletes the language after confirmation	Stop offering a language
Arrow at the row end	Opens the published text file in a new tab. Only imported languages have it.	Read or save the current texts

Other controls on this page

Control	What it does	Why
Paging below the table	Shows the count and moves between pages of seven languages	Long lists stay readable
Cancel in either dialog	Closes the dialog without changes	Leave without adding or importing

Who sees what

Part	Who sees it
The sidebar entry Languages and this page	Super Admin only
A direct link for any other staff role	You do not have permission to view this page.
The languages added here	Every staff member and customer, in their language selector

What you need to know

Topic	Fact
Sorting and size	Sorted by code, seven per page.
Display names	Come from the translated language names. A code without one shows a raw key.
Refresh	The list reloads about once a minute and after every change.
English	The base for every language. Keep it.
Language of new accounts	A new customer starts in the language the registration or invitation page was shown in. That is the browser’s language when it is listed here, English otherwise. Existing accounts keep their language, and accounts that had none use English.

Frequently asked questions

General

The sidebar entry, the heading and the tab of this page use different labels. In English the sidebar reads Languages and the heading Translations. It is one page under Languages.

Who can open this page?

Only staff with the Super Admin role. Other roles see no sidebar entry. Through a direct link they see the message You do not have permission to view this page..

Which language does a new account start in?

The language the registration or invitation page was shown in. That page follows the browser’s language when the language is listed here, and English otherwise. A language added but never imported counts as listed, so such users see English texts until its column is imported. Users change their language on their Settings tab.

What does a dash in the updated date column mean?

The language was added, but no CSV file with its column has been imported yet. Users who choose it see English texts. Import a file with a column headed by its code to give it texts.

Adding and importing

Why does the add dialog accept en-US when the import does not?

The add dialog allows regional and three-letter codes, but the import accepts only two-letter column headers. Use two-letter codes such as pl. Otherwise the language can never receive texts through the import.

Why is the upload button disabled?

The buttonUpload stays disabled until you choose a file with Choose file. While an upload is running, the dialog buttons are disabled as well.

Why did the date of my language not change after an import?

Its code was not added before the import, or its column was missing from the CSV file. The import reports success even when columns are skipped. Add the language under Languages and import again.

Deleting and files

Where can I see the current texts of a language?

The arrow at the end of an imported language’s row opens its published text file in a new browser tab. Languages that were never imported have no arrow, because no file exists yet.

What happens if I delete a language by mistake?

The language and its files are gone at once. Add it again and import a CSV file with its column. Users who had chosen it see English in the meantime. Texts that existed only in the deleted file cannot be recovered.

Troubleshooting

Symptom	What to check
You do not have permission to view this page.	Only Super Admin staff can open the page.
Failed to delete language.	Reload the list. A colleague may have deleted the language already.
A display name shows a raw key	The code has no translated name. Check the code.
A red message with a technical text after uploading	Read the red line inside the dialog for the real reason.
Error loading data in the table	Reload the console and check that you are still signed in.