# Languages

Source: https://docs.settlemint.com/docs/console/organisation-settings/languages
Choose which of the ten languages your organisation offers, pick your own Console language from the account menu, and read how Arabic runs right to left.

An organisation owner chooses which of the ten Console and Investor portal languages the people in the organisation can pick, and English is always one of them. The Investor portal is the app your investors use. Each person then picks their own language from the account menu, and Arabic shows the whole layout right to left.

![Language and time zone section of General with a checkbox for each of the ten languages](https://docs.settlemint.com/docs/screenshots/console-organisation-general-languages.light.en.webp)

[Screenshot] The "Language and time zone" card holds the "Languages" row and ten checkboxes, one per language by its own name.

The "Languages" row carries the note "People in your organisation can choose from these languages." "English" is selected and shows "Always on". Below it, the "Display time zone" row shows the zone in use.

| Language | Name in the language menu | Code |
| --- | --- | --- |
| English | English | `en-US` |
| German | Deutsch | `de-DE` |
| Arabic | العربية | `ar-SA` |
| Japanese | 日本語 | `ja-JP` |
| French | Français | `fr-FR` |
| Dutch | Nederlands | `nl-NL` |
| Malay | Bahasa Melayu | `ms-MY` |
| Indonesian | Bahasa Indonesia | `id-ID` |
| Thai | ไทย | `th-TH` |
| Korean | 한국어 | `ko-KR` |

In every Console language, the language menu shows each language that the organisation offers by its own name, as in the second column. Arabic is the only one of the ten that reads right to left. The Console and the Investor portal serve their own fonts for Arabic, Thai, Japanese and Korean, also behind an organisation's own theme font, so these scripts and the language names in the menu display on a computer that has no font for them installed. The Arabic text is Modern Standard Arabic. A browser that asks for a regional form of Arabic, such as `ar-AE` for the United Arab Emirates, gets this Arabic.

The **Language and time zone** section of General also holds the display time zone. [General](https://docs.settlemint.com/docs/console/organisation-settings/general) covers the rest of that page, and [Profile](https://docs.settlemint.com/docs/console/my-account/profile) covers your own account details.

## Before you start [#before-you-start]

- **To choose the organisation's languages,** you must be an owner of the active organisation, which is the organisation you are signed in to. "Organisation settings" and its "General" page show in the sidebar for organisation owners and platform administrators. A platform administrator who is not an owner of the organisation sees the languages but cannot change them in the Console.
- **To pick your own language,** you need no role. The language menu shows only when your organisation offers more than one language. Before you sign in, the sign-in screens offer all ten.

## Steps [#steps]

### Open the Language and time zone section [#open-the-language-and-time-zone-section]

Open "Organisation settings", then "General", and select **Language and time zone** in the section index at the side of the page. The section has its own address, `/org-settings/general#language-and-time-zone`.

### Select or clear languages [#select-or-clear-languages]

The **Languages** row shows the text "People in your organisation can choose from these languages." and one checkbox for each of the ten languages. Select the checkbox of a language to offer it. Clear the checkbox to stop offering it. "English" stays selected and shows "Always on".

Note (Clearing a language moves its users to English): When you clear a language, every staff member and investor who uses it gets English, at the latest the next time they reload the page or sign in again. Tell them before you clear it.

Each change saves at once. The row shows "Saving…" and then **Languages saved**. The checkboxes are unavailable while the save runs.

During organisation onboarding, the **Languages** field shows the same ten checkboxes, all selected, so a new organisation starts with all ten languages. An organisation that never saved a choice also offers all ten.

## Pick your own language [#pick-your-own-language]

Any signed-in user can do this from the account menu. It is not a setting of the organisation.

### Open the account menu [#open-the-account-menu]

Select your name in the Console header to open the account menu. On the sign-in screens and during onboarding, use the language button in the header instead.

### Choose a language [#choose-a-language]

Select **Language**, then select a language in the list. The current language has a check mark, and selecting it again changes nothing. The list is unavailable for a moment while the Console loads the new language. The Console then changes language without a page reload.

![Account menu open with the Language entry above the theme control](https://docs.settlemint.com/docs/screenshots/console-account-menu-language.light.en.webp)

[Screenshot] The account menu lists "Profile", "My participants", "On-chain identity", "API keys" and "Security", then "Language" and the theme control.

"Language" opens a submenu that lists the languages the organisation offers by their own names, such as "English", "Deutsch" and "العربية", with a check mark on the current language. On a phone the languages sit in the account menu under a "Language" heading instead, so nothing opens over the other rows.

## What the language changes [#what-the-language-changes]

Most of the Console's labels and messages have a translation in each of the ten languages. A text with no translation, and some text the chain or the platform sends, shows in English.

- Numbers use the decimal mark and grouping of the language, and the digits 0 to 9 in every language, Arabic included. Amounts, counts, table page numbers, chart axes, dates and the fields where you type a number all show 0 to 9, the same digits as the addresses and codes beside them.
- A number field's example, such as `e.g., 1,000,000` or German `z. B. 1.000.000`, uses the language's word for "for example" and its grouping, so Arabic reads `مثال: 1,000,000`.
- In the Investor portal, the order ticket, the amend order dialog, the order review rows, the signing line and the amounts the ticket works out, such as the order value and the amount reserved, also show 0 to 9.
- A number field accepts a number typed in the form of the language, such as German **1.234,56**, Arabic-Indic digits, or Japanese full-width digits. It also accepts the digits 0 to 9. When you leave the field, it shows the number with the digits 0 to 9.
- Dates and relative times show in the language, on the Gregorian calendar in every language. An Arabic date is a Gregorian date, not a Hijri date, and a Thai date shows the year 2026, not the Buddhist Era year 2569.
- Lists of names, currencies, roles and countries use the list form of the language, such as "A, B, and C" in English, "A, B und C" in German and "A、B、C" in Japanese.
- The compliance templates, asset classes, instrument templates and instrument structures that come with the platform show their names and descriptions in the language. A name your organisation typed stays as typed. An entry that comes with the platform and has no translation shows its stored English text.
- A compliance rule summary shows in the language, with the plural forms and country names of the language.
- The audit trail names each recorded operation as one action phrase in the language, such as "Place order" or "View asset" in English.
- The title of a failed transaction that a smart contract refused shows in the language on the activity details sheet and the dashboard Needs attention item, with the amounts and accounts of the refusal filled in. The Why and What to do next texts stay in the English the platform sends, under the caption "Original chain or server text" in the language, unless the Console has its own text for that refusal. A refusal the Console has no title for shows the platform's English title.
- A failed submission in the Submissions tray, and on the dashboard Needs attention item, shows the title, reason and next step that the Console wrote in the language you use now, also after you change language. A submission that failed before this was recorded, and text that the platform or a form wrote itself, shows as recorded. Text the platform sent keeps its own left-to-right direction inside Arabic text, so its sentences end where they should.
- The message that reports a refused change, such as a compliance rule change, shows its next step in the language when the platform sent the standard next step for that error. A next step the platform wrote for that one refusal shows in the English the platform sends.

## Arabic reads right to left [#arabic-reads-right-to-left]

When you select Arabic, the page direction changes to right to left, so the layout, menus and reading order mirror. Selecting a left-to-right language restores the layout at once.

The language menu stores your choice in a language cookie in that browser. When the cookie names Arabic, the platform sets the direction before it sends the page, so the page does not change direction while it loads. On a new device, the first page after sign-in can open in the browser's language and then change to the language saved on your account.

- A chart keeps its axes left to right, so time still runs from left to right. The legend and the text around the chart follow the page direction. The axes of a vote result chart also follow the page direction. The date and time on an axis read as one right-to-left phrase, so a day stays with its month and the time follows them.
- Figures keep the same fixed-width face as in English, including the trading prices, quantities and percentages in the Console and Investor portal. Arabic words in compact amounts keep their joined letters. The approximation sign **≈** stays beside its amount, before the digits, and the currency stays with the amount. When a chart breakdown or the dashboard allocation card shows less than one percent, the less-than sign stays before the percentage, and the Required and Warning levels on the collateral chart keep the percent sign beside their number.
- Text your organisation typed, such as an English template name, takes the direction of its own words. When an English name is too long for its space on an Arabic page, the platform cuts the end of the English text and shows an ellipsis on its right.

## How the platform picks a language [#how-the-platform-picks-a-language]

The platform picks a language in this order:

1. Before it sends a page, the platform uses the language in the browser's language cookie. The cookie holds the last language that browser used.
2. With no cookie, it uses the first language in the browser's language list that is one of the ten. It goes down the list from the most preferred language. A regional form matches its base language, so `de-AT` gets German.
3. With no match, it uses English.
4. After you sign in, the Console changes to the language saved on your account. The saved language comes before the cookie and the browser list.

At each step, a language the organisation does not offer becomes English.

Error messages from the sign-in and account screens, such as a wrong password, use the language in the cookie. Without a cookie, they use the browser's language. When the browser's language is not one of the ten, they use English.

## Language of emails [#language-of-emails]

The platform picks the language of each email for its recipient. It uses the first of these that applies:

1. The language saved on the account of the recipient's email address.
2. When the recipient has no account yet or never selected a language, the language of the person who sent the email, for an email that has a sender, such as an invitation.
3. English.

When the email belongs to an organisation that does not offer the picked language, the email is in English. The organisation has no separate default language for emails.

- An investor who sees the Investor portal in Arabic only because of the browser language has no saved language. An email to that investor is then in the sender's language, or in English when the email has no sender. The investor gets emails in Arabic after selecting Arabic in the account menu while signed in.
- An Arabic email reads right to left. Dates use the Gregorian calendar in the organisation's display time zone and name that zone. Dates, times and amounts show the digits 0 to 9 in every language, Arabic included. Amounts use the grouping and decimal mark that go with those digits, such as **1,234.56**.

## The Investor portal [#the-investor-portal]

The Investor portal uses the same ten languages and follows the same organisation setting. Before sign-in it offers all ten. After sign-in it offers the organisation's languages, and a saved choice outside them becomes English. When the portal cannot read the organisation's languages, or the read takes longer than two seconds, it offers all ten for that page.

The language button is next to the theme button on the sign-in and onboarding screens, and the account menu has the same **Language** entry as the Console. An Arabic portal page shows right to left. A token symbol in Arabic text keeps its own direction.

The pages an investor opens after sign-in read in the chosen language, with the Console's wording. That includes the **Working as** page and its "Register in organisation" dialog, the "Invest" page with its offering cards, the title of each page in the browser tab, the Export, View and page controls of every table, and the reason shown when the platform refuses a withdrawal or a register line request.

## You should see [#you-should-see]

- **Your own language.** Menus, labels, dates and numbers change at once, and the account menu shows the check mark next to the language you selected. In Arabic the layout changes to right to left. When you are signed in, the platform saves the choice on your account. When you sign in with the same account on another device or in the Investor portal, the platform changes to the saved language after sign-in, if your organisation offers it. A choice made before sign-in stays in that browser only.
- **The organisation's languages.** The row shows "Languages saved" and the checkboxes show the new set. Your own language menu shows the new set without a page reload. Other people get the new set at the latest when they reload the page or sign in again. From then on, a person whose language you cleared sees English. Their saved choice stays on their account. If you offer that language again, it applies again after they reload the page or sign in again.

## Troubleshooting [#troubleshooting]

**The language menu is missing**

Your organisation offers only English, so there is no other language to select. Ask an organisation owner to offer
more languages on **General**.

**The Console went back to English**

The organisation stopped offering the language you used, or your browser asks for a language the organisation does not
offer. Select another language from the account menu, or ask an organisation owner to offer yours again. Your saved
choice applies again the next time the Console loads after the organisation offers it.

**The language changes after you sign in**

After sign-in, the Console uses the language saved on your account, which comes before the sign-in screen's language.
Select the language you want from the account menu to save a new one.

**An investor gets emails in English**

The investor has no saved language, or the organisation does not offer the saved one. Ask the investor to select their
language in the Investor portal account menu while signed in, and check that the organisation offers it.

**The language checkboxes are unavailable**

The checkboxes are unavailable while a save runs. When they stay unavailable, your role cannot change organisation
settings in the Console, and the page header shows "Organisation owners manage these settings." Ask an organisation
owner to make the change.

**A language change does not save**

The row shows the reason the platform gives, or "The languages could not be saved" when it gives none. The checkboxes
keep the languages that were stored before. Reload the page to load the current languages and your current role, then
try again.

**Some text stays in English**

Names and descriptions your organisation typed show as typed. A text that comes with the platform and has no
translation in your language shows in English, and so do the Why and What to do next texts of a refused transaction
when the Console has no text of its own for that refusal.

**The sign-in screen offers a language the organisation turned off**

Before sign-in there is no organisation, so the sign-in screens offer all ten languages. After sign-in, the language
menu offers only the organisation's languages, and a choice outside them becomes English.

## API routes [#api-routes]

The [Platform API](https://docs.settlemint.com/docs/api-reference/v2) gives access to the same settings:

- `GET /api/v2/users/me` returns your saved language as `language`, or `null` when you never selected one.
- `PATCH /api/v2/users/me` with a body such as `{ "language": "ar-SA" }` saves your language. Any signed-in user can set their own.
- `GET /api/v2/settings/enabled-languages` returns the organisation's `languages` and their `source`. The `source` is `organization` when the organisation saved a list, and `default` when it never saved one. With `default`, `languages` holds all ten. The route needs no sign-in, and without a signed-in organisation it returns all ten.
- `POST /api/v2/settings` with the key `ENABLED_LANGUAGES` saves the organisation's set. The value is the list as JSON text, such as `"[\"en-US\",\"ar-SA\"]"`. The platform refuses a list that leaves out `en-US`, names a language twice, or names a code outside the ten. The route accepts an organisation owner or a platform administrator.

[Error handling](https://docs.settlemint.com/docs/api-reference/errors) explains the response to a refused request.