Languages and reading direction

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#

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#

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.

ENEnglishARArabic

11, opens the full size screenshot

“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#

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#

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#

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#

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 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.

Troubleshooting#

API routes#

The Platform API 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 explains the response to a refused request.