What’s the best structure for i18n JSON files?

A good JSON file structure should be consistent, human-readable, and scalable as your app grows. Most i18n setups use key-value pairs, where each key represents a translatable string, and values are the translations.

{
  "home": {
    "title": "Welcome",
    "description": "Your productivity hub"
  },
  "buttons": {
    "save": "Save",
    "cancel": "Cancel"
  }
}

This nested structure keeps related strings grouped logically (e.g., by screen or feature) and makes maintenance easier. Avoid repeating the same text across files — instead, reuse common keys where possible. Localazy supports any standard i18n JSON format, helping you upload, translate, and export your files effortlessly. You can also define custom file structures and naming patterns to match your project setup.