* fix: Label Composer Thinking Levels and State the One-Shot Scope * test: Cover Composer Thinking Labels and One-Shot Scope in E2E * test: Cover Thinking Focus for Option Lists Without Auto * test: Wait for the Thinking Popover's Open Focus Before Arrow Keys * test: Match the High Effort Radio Exactly * fix: Keep the Composer Thinking Level for the Rest of the Conversation * fix: Keep a Queued Turn's Picked Level on the Turns Queued After It * test: Name the Numeric Reasoning Control by Its Thinking Label * fix: Name the Queued Turn's Level on the Thinking Button * test: Dismiss the Thinking Tooltip Before Typing on a Phone * fix: Respect Enforced Specs and Parameters Edits Over the Inherited Thinking Level * test: Expect the Model Spec Enforcement Flag in Chat Settings * fix: Keep a Queued Turn Off a Level Its Target No Longer Runs * fix: Record the Target a Queued Turn's Level Belongs To * refactor: Inherit the Thinking Level on the Server * perf: Answer the Branch Level Lookup Without Tree Links When Nothing Was Picked * fix: Respect the Thinking Switch and Held Queue Rows Over the Inherited Level * fix: Read the Branch Level Once and Inherit Only on Fresh Turns * fix: Keep a Parameters Thinking Edit From Turning Thinking On * fix: Withdraw a Staged Thinking Level When Thinking Is Switched Off * fix: Scope the Thinking Switch Transition to the Conversation * test: Drop the One-Shot Thinking Scenario the Conversation Level Replaces |
||
|---|---|---|
| .. | ||
| ar | ||
| bo | ||
| bs | ||
| ca | ||
| cs | ||
| da | ||
| de | ||
| en | ||
| es | ||
| et | ||
| fa | ||
| fi | ||
| fr | ||
| he | ||
| hi | ||
| hu | ||
| hy | ||
| id | ||
| is | ||
| it | ||
| ja | ||
| ka | ||
| ko | ||
| lt | ||
| lv | ||
| mr | ||
| nb | ||
| nl | ||
| nn | ||
| pl | ||
| pt-BR | ||
| pt-PT | ||
| ru | ||
| sk | ||
| sl | ||
| sv | ||
| ta | ||
| th | ||
| tr | ||
| ug | ||
| uk | ||
| vi | ||
| zh-Hans | ||
| zh-Hant | ||
| i18n.ts | ||
| README.md | ||
| Translation.spec.ts | ||
LibreChat Localization Guide
This guide explains how to add new languages to LibreChat's localization system.
Adding a New Language
To add a new language to LibreChat, follow these steps:
1. Add the Language to Locize Project
- Navigate to the LibreChat locize project,
- Click the "ADD LANGUAGE" button, typically found within the "..." menu of the "Start to translate" card on the project overview page.
2. Update the Language Selector Component
Edit client/src/components/Appearance/Selectors.tsx and add your new language option to the languageOptions array:
{ value: 'language-code', label: localize('com_nav_lang_language_name') },
Example:
{ value: 'bo', label: localize('com_nav_lang_tibetan') },
{ value: 'uk-UA', label: localize('com_nav_lang_ukrainian') },
Note: Use the appropriate language code format:
- Use simple codes (e.g.,
bo) for languages without regional variants - Use region-specific codes (e.g.,
uk-UA) when needed
3. Add Localization Keys
In client/src/locales/en/translation.json, add the corresponding localization key for your language label:
"com_nav_lang_language_name": "Native Language Name",
Example:
"com_nav_lang_tibetan": "བོད་སྐད་",
"com_nav_lang_ukrainian": "Українська",
Best Practice: Use the native language name as the value.
4. Create the Translation File
Create a new directory and translation file:
mkdir -p client/src/locales/[language-code]
Create client/src/locales/[language-code]/translation.json with an empty JSON object:
{}
Example:
client/src/locales/bo/translation.jsonclient/src/locales/uk/translation.json
5. Configure i18n
Update client/src/locales/i18n.ts:
- Import the new translation file:
import translationLanguageCode from './language-code/translation.json';
- Add it to the
resourcesobject:
export const resources = {
// ... existing languages
'language-code': { translation: translationLanguageCode },
} as const;
Example:
import translationBo from './bo/translation.json';
import translationUk from './uk/translation.json';
export const resources = {
// ... existing languages
bo: { translation: translationBo },
uk: { translation: translationUk },
} as const;
6. Handle Fallback Languages (Optional)
If your language should fall back to a specific language when translations are missing, update the fallbackLng configuration in i18n.ts:
fallbackLng: {
'language-variant': ['fallback-language', 'en'],
// ... existing fallbacks
},
Translation Process
After adding a new language:
- The empty translation file will be populated through LibreChat's automated translation platform
- Only the English (
en) translation file should be manually updated - Other language translations are managed externally
Language Code Standards
- Use ISO 639-1 codes for most languages (e.g.,
en,fr,de) - Use ISO 639-1 with region codes when needed (e.g.,
pt-BR,zh-Hans) - Tibetan uses
bo(Bodic) - Ukrainian uses
ukoruk-UAwith region
Testing
After adding a new language:
- Restart the development server
- Navigate to Settings > General
- Verify your language appears in the dropdown
- Select it to ensure it changes the UI language code
Notes
- Keep language options alphabetically sorted in the dropdown for better UX
- Always use native script for language names in the dropdown
- The system will use English as fallback for any missing translations