# General Translation React SDKs (gt-react, gt-next): loadTranslations
URL: https://generaltranslation.com/es/docs/react/reference/functions/load-translations.mdx
---

title: loadTranslations
description: Personaliza cómo se cargan las traducciones en producción con General Translation gt-react. Referencia de la API de loadTranslations.

---

`loadTranslations` es una función `loader` que defines para personalizar desde dónde `gt-react` lee las traducciones en producción. Pásala a la [llamada de inicialización](/docs/react/reference/config#initialization) para cargar las traducciones desde un origen distinto de la CDN predeterminada de General Translation.

*Se aplica a `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`, pero la integración varía. `loadTranslations` es un `loader` que defines, no un símbolo exportado. En `gt-react` y `gt-tanstack-start`, pásalo a la llamada de inicialización (abajo). `gt-next` lo resuelve mediante el plugin `withGTConfig` (documentado en la sección de Next.js), y `gt-react-native` carga las traducciones a través de la configuración de su proveedor. El contrato del `loader` en esta página es el mismo en todos los casos.*

## Resumen general [#overview]

Define una función que reciba una configuración regional y devuelva sus traducciones; luego pásala como la opción `loadTranslations` a [`initializeGT`](/docs/react/reference/config#initialize). En las aplicaciones de una sola página, pásala a [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) en su lugar.

```tsx
const loadTranslations = (locale: string) =>
  import(`./_gt/${locale}.json`).then((m) => m.default);

initializeGT({ ...gtConfig, loadTranslations });
```

*Nota: en `gt-react`, `loadTranslations` es una opción de configuración de la llamada de inicialización, no una propiedad de [`<GTProvider>`](/docs/react/reference/components/gt-provider). De forma predeterminada, las traducciones se cargan desde la CDN de General Translation.*

## Cómo funciona [#how-it-works]

En producción, tus traducciones deben almacenarse en algún lugar desde donde puedan leerse en tiempo de ejecución. De forma predeterminada, se cargan desde la CDN de General Translation. Proporciona `loadTranslations` para cargarlas desde otra fuente, como:

* El bundle de tu aplicación (lo más habitual).
* Una base de datos.
* Una API.
* Una CDN distinta.

`gt-react` incluye soporte integrado para cargar traducciones desde archivos locales dentro de tu bundle. Consulta [Almacenar traducciones localmente](/docs/react/guides/storing-translations).

## Parámetros [#parameters]

| Parámetro           | Descripción                                                         | Tipo     | Opcional | Predeterminado |
| ------------------- | ------------------------------------------------------------------- | -------- | -------- | -------------- |
| [`locale`](#locale) | La configuración regional para la que se cargarán las traducciones. | `string` | No       | —              |

### `locale` [#locale]

**Tipo** `string` · **Obligatorio**

La configuración regional para la que deben cargarse las traducciones.

## Devuelve [#returns]

**Tipo** `Promise<unknown>`

Una promesa que se resuelve en las traducciones de la configuración regional dada.

## Ejemplos [#examples]

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  const translations = await import(`./_gt/${locale}.json`);
  return translations.default;
}
```

```js title="loadTranslations.js"
export default async function loadTranslations(locale) {
  try {
    const response = await fetch(`https://your-cdn.com/translations/${locale}.json`);
    return await response.json();
  } catch (e) {
    console.error(e);
    return {};
  }
}
```

## Notas [#notes]

* `loadTranslations` personaliza cómo se cargan las traducciones en producción; su uso más habitual es [las traducciones locales](/docs/react/guides/storing-translations).
* Si quieres usar tus propias traducciones hechas por personas con una biblioteca de i18n independiente, usa [`loadDictionary`](/docs/react/reference/functions/load-dictionary) en su lugar.