Files
Charon/docs/features/localization.md
2026-01-26 19:22:05 +00:00

2.6 KiB

title, description
title description
Multi-Language Support Interface available in English, Spanish, French, German, and Chinese

Multi-Language Support

Charon speaks your language. The interface is available in English, Spanish, French, German, and Chinese. Switch languages instantly in settings—no reload required.

Overview

Charon's interface is fully localized, making it accessible to users worldwide. All UI elements, error messages, and documentation links adapt to your selected language. Language switching happens instantly in the browser without requiring a page reload or server restart.

Supported Languages

Language Code Status
English en Complete (default)
Spanish es Complete
French fr Complete
German de Complete
Chinese (Simplified) zh Complete

Why Use This

  • Native Experience: Use Charon in your preferred language
  • Team Accessibility: Support multilingual teams
  • Instant Switching: Change languages without interruption
  • Complete Coverage: All UI elements are translated

Changing Language

To change the interface language:

  1. Click your username in the top-right corner
  2. Select Settings
  3. Find the Language dropdown
  4. Select your preferred language

The interface updates immediately—no reload required.

Per-User Setting

Language preference is stored per user account. Each team member can use Charon in their preferred language independently.

Browser Language Detection

On first visit, Charon attempts to detect your browser's language preference. If a supported language matches, it's selected automatically. You can override this in settings at any time.

What Gets Translated

  • Navigation menus and buttons
  • Form labels and placeholders
  • Error and success messages
  • Tooltips and help text
  • Confirmation dialogs

What Stays in English

Some technical content remains in English for consistency:

  • Log messages (from Caddy/CrowdSec)
  • API responses
  • Configuration file syntax
  • Domain names and URLs

Contributing Translations

Help improve Charon's translations or add new languages:

  1. Review the Contributing Translations Guide
  2. Translation files are in the frontend locales/ directory
  3. Submit improvements via pull request

We welcome contributions for:

  • New language additions
  • Translation corrections
  • Context improvements