# gt: General Translation CLI tool: JSON
URL: https://generaltranslation.com/es/docs/cli/reference/formats/json-files.mdx
---

title: JSON
description: Traduce archivos JSON con la CLI de General Translation. Referencia de la API del formato de archivo JSON.

---

La CLI traduce archivos JSON independientemente de la biblioteca de i18n que uses. Las traducciones conservan la sintaxis original de las cadenas.

*Nota: La sintaxis y el formato personalizados de las cadenas —por ejemplo, los mensajes ICU— son compatibles con `next-intl` e `i18next`. Otras bibliotecas pueden traducir con menos precisión las cadenas con sintaxis personalizada.*

## Configuración [#config]

Agrega una entrada `json` en `files` con un array `include` de patrones glob. Usa el marcador de posición `[locale]` para que la CLI pueda encontrar los archivos fuente y guardar las traducciones en la ruta correcta.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"],
      "exclude": ["i18n/[locale]/exclude/**/*.json"]
    }
  }
}
```

Con esta configuración, la CLI traduce todos los archivos JSON dentro de `i18n/en/`, guarda los resultados en `i18n/zh/`, `i18n/es/` y `i18n/ja/`, y omite los archivos dentro de `i18n/en/exclude/`. Consulta la [referencia de configuración](/docs/cli/reference/config#files) para ver todas las claves de archivo.

## Metadatos por clave [#metadata]

Adjunta instrucciones de traducción por clave con un archivo complementario `.metadata.json` que replique la estructura de tu fuente de origen. Úsalo para añadir contexto, límites de caracteres o contexto del código fuente para claves específicas sin cambiar la fuente.

```json title="translations.metadata.json"
{
  "nav": {
    "bank": {
      "context": "Riverbank — the side of a river. NOT a financial institution."
    },
    "save": {
      "context": "Sports term — a goalkeeper preventing a goal. NOT saving data.",
      "maxChars": 12
    }
  }
}
```

Consulta la [referencia de metadatos por clave](/docs/cli/reference/keyed-metadata) para ver todos los campos admitidos.