Docs/Customization
Customization

i18n

Multi-language support. Translation files and locale config.

Last updated Mar 19, 2026

ZShip supports multiple languages via i18n configuration.

Translation files

  • Web: apps/web/src/i18n/locales/en.json, zh-CN.json, etc.
  • Dashboard: packages/dashboard/ or shared i18n
  • Admin: apps/admin/i18n/locales/

Adding a language

  1. Add a new JSON file (e.g. ja.json) to the locales folder
  2. Add the locale to utils.ts or the i18n config
  3. Update routing if using locale-prefixed paths (e.g. /ja/)

Keys

Translation keys follow a nested structure. Add new keys for new UI strings. Existing keys can be overridden per locale.