#20905: i18n: add bulgarian to openclaw
app: web-ui
size: S
Cluster:
Internationalization Enhancements
## Summary
Describe the problem and fix in 2–5 bullets:
- Problem: Missing Bulgarian in OpenClaw
- Why it matters: So non-technical Bulgarians can also benefit
- What changed: Added bulgarian language
- What did NOT change (scope boundary): Anything else
## Change Type (select all)
- [ ] Bug fix
- [ ] Feature
- [ ] Refactor
- [ ] Docs
- [ ] Security hardening
- [x] Chore/infra
## Scope (select all touched areas)
- [ ] Gateway / orchestration
- [ ] Skills / tool execution
- [ ] Auth / tokens
- [ ] Memory / storage
- [ ] Integrations
- [ ] API / contracts
- [x] UI / DX
- [ ] CI/CD / infra
## Linked Issue/PR
Relates to https://github.com/openclaw/openclaw/issues/3460
## User-visible / Behavior Changes
User can now switch to Bulgarian language in the Control UI Language picker.
## Security Impact (required)
- New permissions/capabilities? (`Yes/No`) No
- Secrets/tokens handling changed? (`Yes/No`) No
- New/changed network calls? (`Yes/No`) No
- Command/tool execution surface changed? (`Yes/No`) No
- Data access scope changed? (`Yes/No`) No
- If any `Yes`, explain risk + mitigation: N/A
## Repro + Verification
### Environment
- OS: Any
- Runtime/container: N/A
- Model/provider: N/A
- Integration/channel (if any): N/A
- Relevant config (redacted): N/A
### Steps
1. Open Control UI page
2. Open the "Language" dropdown and select Bulgarian
3. All available strings are now translated to bulgarian
### Expected
- All existing translations, titles, subtitles and nav items switch to Bulgarian
### Actual
- All existing translations, titles, subtitles and nav items switch to Bulgarian
## Evidence
Attach at least one:
- [ ] Failing test/log before + passing after
- [ ] Trace/log snippets
- [ ] Screenshot/recording
- [ ] Perf numbers (if relevant)
## Human Verification (required)
What you personally verified (not just CI), and how:
- Verified scenarios:
- Edge cases checked:
- What you did **not** verify:
## Compatibility / Migration
- Backward compatible? (`Yes/No`) Yes
- Config/env changes? (`Yes/No`) No
- Migration needed? (`Yes/No`) No
- If yes, exact upgrade steps: N/A
## Failure Recovery (if this breaks)
- How to disable/revert this change quickly: Revert this commit only
- Files/config to restore: `i18n/lib/translate.ts` and other `i18n/lib/` touched files
- Known bad symptoms reviewers should watch for: Odd styling due to the lenght of some words in english vs bulgarian
## Risks and Mitigations
List only real risks for this PR. Add/remove entries as needed. If none, write `None`.
- Risk: Odd styling in some places to the lenght of the English vs Bulgarian translations
- Mitigation: Find a more suitable shorter/longer version of the bulgarian translation
<!-- greptile_comment -->
<h3>Greptile Summary</h3>
Added Bulgarian (`bg`) language support to OpenClaw's i18n system. Updated locale type definitions, translation manager with auto-detection and lazy loading for Bulgarian, created complete Bulgarian translation file with all 99+ translation keys matching the English structure, and updated all existing locale files to include Bulgarian in the language picker.
- Complete Bulgarian translations provided for all UI strings
- Auto-detection for `navigator.language` starting with "bg" properly implemented
- Lazy import logic correctly handles the Bulgarian locale
- All language picker dropdowns updated across locale files
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with no risk
- The implementation is straightforward and follows established patterns. All necessary files are updated consistently, translations are complete, and both auto-detection and lazy loading are properly implemented. The previous review comments have been addressed. This is a well-executed i18n addition with no breaking changes.
- No files require special attention
<sub>Last reviewed commit: 0168664</sub>
<!-- greptile_other_comments_section -->
<!-- /greptile_comment -->
Most Similar PRs
#22332: i18n: add Korean (ko-KR) locale support
by arusia88 · 2026-02-21
77.6%
#9490: Add Internationalization (i18n) Support
by luuman · 2026-02-05
77.3%
#10657: feat(ui): add i18n support with English, Chinese, and Portuguese
by SalimBinYousuf1 · 2026-02-06
76.6%
#21988: feat(i18n): added Thai (th) locale
by samithiwat · 2026-02-20
75.7%
#10586: feat: Add Chinese (zh-CN) localization support
by Maxsong-0 · 2026-02-06
75.5%
#13622: feat(i18n): add complete multi-language support (EN, TR, FR, DE)
by vaur94 · 2026-02-10
73.2%
#19338: Create README_TR
by lutraat · 2026-02-17
72.9%
#18767: docs: add Portuguese translations for glossary, agent concepts, and...
by jadilson12 · 2026-02-17
71.7%
#19689: feat(i18n): added Filipino (fil) locale
by warengonzaga · 2026-02-18
71.5%
#21617: feat(i18n): added korean locale
by Jaejuna · 2026-02-20
71.4%